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3y Michipiel R. Harvey 

Itanium, and 
Pentium, and 
MacTel, oh my! 

Lucifer has just set up a snow cone stand down on the corner. 

The thing that w'ould never happen, happenetL Apple announced 
at the June Worldwide Developers Conference that, beginning in 
2006, Macs will ship with Intel Inside. Has the chime begun to 
haunt your dreams yet? 



All over the Mac web, and on a great many mailing lists, 
variations on “the sky is falling!” theme arc being played out. But, 
why? Let’s l(X)k at a few of the contentions of (he complainers. 

First, Intel is evil. They are (he bad guys, in cahoots with 
Microsoft, ihey are SA7'AN! Meh. That’s MacMac thinking, and has 
no place in reasoned discussion. Intel Is a company that makes 
chips. IBM is a company that makes chips. Apple no longer sees 
IBM heading in the direction they need. Evidence the lack of a GS 
PowerBook now and in the forcsecalTlc future. The roadmap as 
given to Apple had both dc.sktops amning at t>ver 3 GHz, ancl 05 
PowerBcxjks in the .stores today. It didn't hapiien, nor was it going 
to. ’Hie 970 roadmap took a left when Apple needed to go right. 
Intel is willing to meet Apple’s needs, anti it would .seem, has 
shown Apple they can get there, while IBM canntH. 

Second, the problem of rewriting code to am on Marklar. This 
Is, for the most part, a nonstarter. Yes, there are going to be some 
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players wlio are going to get bit real hard by this. Developers 
doing really unique things with the Mac that required 
nonstandard coding to work will have to find new ways to do that 
same thing. Stuff written in Asseinlily is gt>ing to need to be 
reworked, or rethought. If you hand-tuned some of your code, 
you’ll be doing it again. Game developers will run into some 
issues other segments won't. But, didn't you already do that .stuff 
once or twice before? It’s not an insurmountable task. Cocoa 
developers, you’re in pretty good shape. Anyone whose code 
ba.se is in Xcode is as close to golden as you can get here. For 
most CtKoa programmers, who weren’t making bad assumptions, 
it’s two hours of work, and a couple of check boxes to build the 
universal binary that will run on l^PC and Intel. Carbon 
ilevelopers on Xcode will have some mtire work to do, ranging 
from "mrt too bad” to ’*1 picked the wrong day to .stop sniffing 
glue”. CodeWarrirors, embrace the horror. You’ve got a bumpy 
road ahead, but it’s not as though this day wasn't coming anyway 
with Mertrowerks slow slide to largely supporting only embedded 
systems. Now, if you’ve been flogging your ancient code base, 
doing as little as po.ssible to keep the app running, then it really 
is time to either step up, and tlo the ((>h right, or just fade into 
that long good night. 

And, this is important; Apple and Intel are going t^^ be there all 
the way, providing every bit of support they can to get you guys 
running on the new hardware. The tools and stippoil coming on 
line for developers is considerable. Xcode 2.1 was made available 
on day one. I talked to one small dev wlio built a universal binary- 
of one of his apps in no time (then all he liad to do was wait for 
the test box from Apple to see if it worked). No one is going to 
have their cheese left hanging in the wind, imle.ss they decide to 
Itang it out there lhem.selve.s. 

That’s not to say there won’t be bumps in the road. The be.sr- 
laid battle plan never survives first contact with the enemy. But, it 
will ultimately work. The job will get done. 

Third, the costs will be out of control. Users, CTO’s, and 
network admins will have to buy everything all over again. No. You 
won’t. This roll out is going to pnx-eed much as the change from 
the 68(X)0 processor to the PowerPC did in the 1990’s, and given 
Apple's experience thanks to that changeover, it will probably l:>e 
much smoother than the 68K-PPC transition was. My gue.s.s? Well, 
for example, I’m betting you’ll get a .x maintenance release of 
Adolie CS 2 .some time next year that will be a univensal binary. 
You won’t see CS 3 until 2007 (CS 2 jiLst came out after all), and it 
will Ix^ a universtil liinary. The usual upgrade co.sl.s will apply. C^ 
4 in 2009 might be Intel only. 
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Everything else will follow similar paths. OS X 10.4.5, say, will 
ship on the MacTels. It will also work on every PPC Mac that can run 
10.4 now. Leopard will be the same, universal binary running on 
liotli chips. 10.6 won’t be. Apple likes to be out front on tlrat .stuff, 
and pull everyone else along with them. That’ll be 2009, probably. 

Microsoft, among others, will probably have a .stjmewhat 
different path. In fact, MS already shared their near term plans at 
the WWDC keynote. Olilce 2004 will stay PowerPC only. It doesn’t 
make sense to put the tiiiie into a universal binary for 2004 when 
it will run acceptably under Rosetta, and their next big rev is due 
around the same time the first MacTels ship. So, universal for Office 
2006 (currently identified a.s Office 12), and maybe 2008, but that 
could go either way. Versions after that will ceitainly be Intel only. 

There is untold opportunity here, let’s not forget. First and 
foremost, there is a great deal of opportunity for both Apple and 
Intel. Intel is the 800-pound gorilla, 'llietr processors are 
everywhere. It’s a good idea for Apple to partner with a company 
with the capacity to meet its needs. Apple brings to the tabic a 
great portfolio of IP that can very likely Ire applied to Intel chip 
designs. How about Ilypcr Transport? HT is a big part of whai 
currently gives AMI) a leg up on processor power the.se days. 
Olwiously, AMD was a member of the constu'tium that developed 
it. Guess who else was? Apple. Intel ju.st got access to a technology 
with ihe ability to help put them up front again, and it didn’t cost 
them a cent in licensing Fees. 

Now, think on tlie ptxssibility of c|i]ick and easy ports of 
software that’s never been considered for the Mac plalform. Had 
tlie Navy ran OS X on MacTel, maybe their Aegis cruisers wouldn’t 
have come to a complete hall during te,sting when the control 
systems crashed Windows NT. Ponder your accounting department 
no longer having to wony about the unending deluge of Windows 
specific virmses and Trojans because your network admin moved 
all of them to MacTcl as .soon as PeopleSoft did a build for it. What 
about tlie ability to dual boot? Phil Schiller said they won’t support 
it, but neither will Apple actively block it, How long until .some 
enterprising hobbyist programmer has a multi-boot hack up on 
Sourceforge? One box, and two, tliree, or four difi'ereni bootable 
OSes. I'd l)e okay with fewer Ixnge boxes under my desk while .still 
being able run all the flavors of Linux, Unix, Windows, and Mac 
OS I want. Or better yet, how about a version of Virtual PC that 
runs all that at native speeds, and lets you fast switch lietween 
each. Hnim, plenty of opportunity all over the place, it seems. 

So, what does it all mean? It means, like Mr. Adams always 
wrote, Don’t Panic. We’ve got a year or tnore lie fore tlie fust 
MacTel hardware will be available for purchase, and even then, all 
the PPC stuff will still work. It’s a long niaci, with many scenic stops 
on the way, to an all Intel Mac universe. By the lime we all get 
there, someone will ask, “So, what was all hul)bub, bub?" 
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GETTING STARTED • by Dave Mark 


PHP And MySQL, 
Together At Last 


I ntei'woven in my last six columns or so were columns that 
showed you how to install and test PHP and MySQL. The PHP 
and MySQL columns all dealt with PHP and MySQL in isolation. 
The PHP code did not access a MySQL database, and the MySQL 
database access was all done via the Terminal and not via a PHP 
encRisted web page. In this month’s column, we’ll verify that both 
are installed and available, then see if we can’t make them play 
nicely together. Let’s start by verifying our install. 


Checking Your 
PHP Install 

If you new to PHP, make your way 
over to http://www.phpmet and browse 
ihrouj'h their documentation. If youVe 
installed even a reasonably recent versiem 
of Mac OS X on your machine, you sliould 
have PKT^ installed. One .solid due that you 
c/u have PHP in.sUilled can be obtained by 
typing this command in Terniinab 

$ 1b /tifir/lcrcal/ 

If the result of this command includes 
the text “php5’", chances are, youVe all set. 
If a doesn't, visit Mark Liyanage's 
wonderful PHP site: 

http://www.enlropy.ch/soflware/macosx/ 

php/ 

Mark has put together an excellent PHP 
resource for Mac OS X and lie does a nice 
job keeping it up to date. ITiough, at this 
writing, the site still lists Mac OS X 10,3 
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the most rec'ently supported, 1 had no trouble using his instaU 
package on my Tiger machine. Obviously, yim1l want to backup 
your machine first, just in tiise sfjinething does go wrong. 

Hopefully, you do have PHP installed on your machine 
ala^ady. Regardless of how yrm goi there, once youVe got PHl^ 
5 installed, here's a simple test to make sure you're all gtxKl. 

Launch your favorite text editor, lie sure it is set to save as 
plain-text, create a new file, then enter this text: 

C?php 

plipitifofj 

?> 

Siive die file as tesl.php and place it in the Sites subfolder 
of your home folder (inside -/Sites/, aka, /Users/xxxx/Sites/). 

To test your new PHP file, launch Safari and type: 

http://127.0.0. l/-davemark/Test php 

Obviously, youJl replace '‘davemark" witli your own user 
name. Safari will ask your Apache server to pass the referenced 
file on ii> the PHP pre-priKessor. If all is kosher, a giant tal>le 
mil api>ear in a Safari window. The Ixfginning of my giant table 
Ls shown in Figure 1, 
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Figure 1. The PHP info table. 

N(He lhai iny cornpultT runiiing PUP version 5.0.4, Youtl 
definitely want lo check on http://php.net to see if ihere’s a later 
version available. 

Checking Your MySQL Install 

If you are new to MySQL, check out http://www,nnysqLcom, 
In ihc Afarcb, 2005 Getting Started column, 1 went through the 
process of hunting down the proper package for yemr version of 
Mac OS X, instilling My,SQL, starting and shutting clown the 
.MySQL server, and setting up the accounts and passwords, 

Tlien, in tlie April Getting Started we used the MySQL monilt>r 
application, running in '^ermin^l], to build a datitl>ase and, witliin 
that, a table. We atkJed to and deleted rows from die table, anti nan 
.some queries lo rqx>it on tile table data. Obviously, 1 don't want to 
rejxrat all that here, but I thcaigfii it wouki be worth repeating a few 
of the basic's, just to make sore' we were on tlie same page. 

Stan l)y making sure you have an alias set up for mysql. In 
Terminal, type this command: 

alias 

llius will list your aliases, i loixAilly, one of your alia.scs will lx‘: 

alias [nyst|l^' /uBr/local/myaql/bin/mysqi' 

If not, edit the hie .p>r)Pie in your home directory and add 
this line to the end of it; 

alias inysql“’ /usr/local/mysql/biti/tiysql' 

Now quit and re-launch Terminal, which will re-cxecuic the 
commands in Now, when you type the alias command, 

your alias should apfiear. This lets us type mysql to launch the 
MySQL monitor. 

biLinch the monitor by typing: 

mysql -u xoQt p 

As a reminder, you are launching the monitor with a user of 
root. You'll 1x1 prompied for a password. Type in the password 


you created when you created your accouiil. Rememl>er, 
this r<x>t is nm Uic Siitne root as your Mac root account. If 
you are liaving trouble logging in as root, go irack to your 
setup instmetions or to the Mauii Getting Started. 

Here's whai my itioniitjr looks like: 

Welcome to tbo MySQL monitor. GonuivandiJ end with : or 

You-C MySQL connection id i:^ 1 to Berver versioni 
ntnndard 

Type "help:* nr *\h' for help. Type ‘\c* to clear the 
btiffer. 

Biysql> 

If mysql does not launch your MySQL mtmitor, cither 
your alias is not set coirecily (in which case, go check to 
see if you've got a file called mysql in the directory 
/usr/local/mysql/bin/) or you did not in.sLaIl MySQL 
correctly. If MySQL was nol in.stallcd correctly, get hold of 
the Mart'll MacTech and follow the installation process, or 
make your way through the MySQL installaljon 
instructions on http://mysql.com. 

A.ssuming your monitor comes up as mine did, type 
this command: 

Bhow databases; 

Don't foget the ending semicolon. Here’s my result: 

Riyijql> fihow databases: 

^ - ^ 

Database | 

I teat I 

I row In set fO.lS sec) 

mysql> 

If youVe played with MySQL, you may find yourself 
with a different set of databases. Nol a problem, As long 
as the command works, youTe fine, no matter the resulc 

Driving MySQL From 
Within PHP 

In April’s column, we used the MySQL monitor to 
C'reaie a database, add rows, delete rows, and update 
values in a table. In the remainder of this monilVs column, 
we’re going to do the same sorts of things, but do diem 
from wiihin PHP, instead of from the monitor. 

Before we get into our PUP example, let’s u.se ihe 
monitor to set up a database and uihle, then populate die 
table. This approach Ls pretty lypical: Set up the database 
and table using die monitor, then query/populate the 
table from your P14P/web interface. 

In the monitor, type this command: 

oiyaql) create database products; 

Query OK, 1 row affected (Q,06 sec) 
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Next, check to make sure the database got created: 
ttysql) show databasesj 
I Database 


nysqt 

products 

test 

3 rows in set tO.OO esc) 


Yup, there it is. Now, let's set products a.s our database and 
tiien create a new table: 

iiiysql> use products; 

Database changed 
mysql) show tables; 

Empty set ( 0.00 sec) 

No tables exist yet. Let's create one: 

iiiysql> create table cables( 

•> name varchartbO), 

*> lengthlnCn inttZK 

-> cableType ENUHC ^firewire'* *usb‘ ). 

-> cablelD intCiO) auto_iftcrement primary key ): 

Query OJC. 0 rows affected (0-15 sec) 


Imagine a database set up for an e-commerce web site, 
designed to store info on all the site's products. The site sells 
firewire and usb cables of various lengths. Tlie cal^les tal>le will 
store info on the varicjus cables sold by the site. Obviously, tills 
is a ver)f simple example. If tliis were a real tlaiabase, we'd want 
to create multiple tables and have them reference each oiher. 
For example, we’d probably create a manufacturer table and 
have a field in die cables talile refer to an entry in that table. 'Illis 
table is not very complicated and would not be terrifically useful 
in the real world, but it wiii serve to demonstmte tlie conneciitin 
between PHP and MySQL. Read on*,. 

Now let’s popiiiaie die talile: 

mysql> iticert into cables values (’Varco DXlOD'. 100, 

*firewire’, 0)i 

Query OX. I row affected (0,13 sec) 

Note that we embedded the manufacturer's name in die 
cable name field, Ick* As 1 mentioned, this should l>e a reference 
to a separate, manufacturer table. For now, ihisll do. 

Notice that we created an enuniemled field. Ttie crablel ype 
field can only take on one of two values, either Tirewirc' or 'u.sb\ 

We u.sed a value of 0 for the cablelD. Ihis asks MySQL to 
create an index for diis entry autamatically. 

Ix^t's retrieve what we just put in: 


mysql) select * from cables: 
- + 


l^name | lengthTnCm | cableType J^cabielD | 


I' 


Varco DXJOOj^ 100 | firewire J^l | 


1 row lo set (0,04 sec) 

Let’s add a few more: 

mysql> insert into cables values (‘Genenco VTlOO', 100, 
’firewire’, 0)j 

Query OX, 1 row affected (0*38 sec) 


rnysql) insert into cables values ('Genenco VT50’, 50, 
’firewire*, 0): 


Query OX, 1 row affected (O.QO sec) 

oysql) insert into cables values ('Geiienco UlOD’, 100, 
'usb** 0): 

Query OK. 1 raw affected {0.00 sec) 

irysql) insert into cables values (’Plexicor uShorty'* 20, 
’ttab*. 0): 

Query OX, 1 ruw affected (0,00 sec) 

rnysql^ insert into cables values ('Plexicor fSborty’* 20, 
‘firewire’, 0); 

Query OK. 1 row affected (0,00 sec) 

Now let’s take a laok at what we've got in the table: 
Diyaql) select * from cables; 

H— — — — = 4 ^ .f « ^ - + 


name 

lengthlnCiH 

cableType 

cablelD 





Varco DXlOO 

100 

firewire 

J 

Genenco VTlOO 

100 

firewire 

2 

Gfiueuco VT50 

50 

firewire 

3 

Genenco UlOO 

too 

ufib 

4 

Plexicot uShocty 

20 

usb 

3 

Plexicor fSborty 

20 

firewire 

b 


6 rows in set (0.39 sec) 


Accessing Your Data from PHP 


So now we have a database and a table filled widi data. Our 
nexl step is to access this data and niiike it appear on a web page. 

As a remincler, your PIfP siaieincnts will he embedded 
wiiliin your html code. Onex* your ,php file has Ixxm handed off 
to tlie PliP pre-processor, the pre-processor will interpret the 
PUP code and replatx the code wiili the cnUpul generated by 
the code. If this confuses you, here's a very short example from 
last November's column, just to refresh your memory. 

Using your plaintext text editor, create a new file called 
mysqitesLpbp and save it in your .Vito folder, right alongside 
your teslpbp file we created earlien Enter this code in the file 
and save: 

<btiai> 

<hf?3d> 

<tltle>PHP Test</tliie> 

</head> 

<body> 

<p>Thifi ifi some pure HTML lovelincss,</p> 

<5php 

echo ■■<p>Hello. World! C/p>\n'’; 

?> 

<p>0i<i we echo properly?</p> 

<?pbp 

echo date{“r’'): 

echo '’\n'*: 

t> 

<p>Tt works 
</body> 

(/html) 


Once your file Ls saved, go into Safari and enter this address: 


http://l 27-0,0. l/-'davemark/mysc|ltest,php 


Make sure you replace *‘davemark” wiiii your own user 
name. Figure 2 shows wku 1 saw when my page loaded. Tlie 
first line was produced by the HTML 'Die second line was the 
result of tlie output of tlje PHP echo function. Tlie echo function 
produced some IFTML which was added to tlie .stream. Next 
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came another line of HI ML (^T)id we echo properly?”), followed 
by another pair of echos, echoing a date string and a return. 
This is all polished off by a last line of HTML, generating die 
siring 'Tt works!!!”. 



Figure 2. A simple PHP test 


If you view source on this output, here's what you get: 

<head> 

<title>FHF Test</title> 

(/head) 

<body> 

<p>'rKliJ is ijome pure HTML lo veil ness, </p> 

<p>HelIo, World!</p> 

<p>Did we echo proj}erly?</p> 

Wed. 15 Jun 2005 19:43:02 0400 

<p>It works!!!</p> 
a body) 

</hUiil> 


Go back and lcx>k at die original PHP. Make sure you 
understand how die original PHP got translated into this source. 
Rememlx^r, every chunk of PHP code in the original source was 
replaced by its output to achieve this HTML listing. 

Connecting to the Database 

OK, now we're ready to fetch our data. Our first step is to 
connect to our daUifjase. Open myaqlleniLphp and replace the 
contents widi diis code: 

<htliil> 

<l’ic‘ad> 

<title>MySQL TGSt</title> 

</bead> 

<body> 

<p>Connecting to tbe database,.,</p> 

<?php 

$host = ^localhoat*: 

Suser = 'root': 

$pw = ; 

$db = 'products *: 

$iink * iKysq^i_connectt Shost. $user, $pw ) 

or diet ‘Could not connect: ' , mysql_error() ); 
echo 'Connected suecessfuiiy': 
mys ql _s e1ec t _db( $db ); 

?> 

<p>If we got here, we've connected I<!/p> 

</body> 

</hti!ii> 


In Lite aix>ve c<xle, replace die $useF and $pw string values 
with whatever user and p;issword you used to aeate Che database. 
Save the code and reload this page in Safari: 


http:// 127.0.0 J/-davemark/mysqltesLphp. Figure 3 shows my results. 



Figure 3. Connecting to the database. 

In a nutshell, we used the Rinction raysqLconneaO to 
connect to the database and the function mysqLselect_dK) to 
select the database. This is like logging in using the MySQL 
monitor, ifien saying im^pwducts. 

One line of code worth taking a second IcKik at is this one: 

$liTik ^ raysql_connect( $host. $ueerp $pw ) 

or diet 'Could not connect: ' . ciysql_crrort) }: 


Notice the use of "or” here, Ihis is a pretty common 
technique in PITP. The second part of the or clause will only 
execute if the first part fails. Tlie dieO function is equivalent to 
exitO. die() will past the passed in string as output, then exit. 

Notice the use of the operator to concatenate two strings 
together This is another common PHP technique. In tliis case, 
the operator will build a single string from 'Could not 
connect: ’ and the string returned by mysc]l_error(). 
mysqLerrorO rciurns the error message from the previous 
MySQL operation. 

Our next step is to query the database and to print the data 
we retrieved 

Querying the Database 

Back in your text editor, open the file mysqllest.php and 
replace its contents with tins: 

<honl> 

<head> 

<title>MyS[5L Test</tit le> 

</iiead> 

<body> 

Cp>Coiiflecting to the database.. .</p> 

<?plip 

$bost " 'localhost*: 

$uiie c = ' roo t': 

$pw ^ * *: 

$db “ 'products'; 

$link = iiiysql_connect ( $hoEt* §user, $pv ] 

or die[ 'Could not connect: ' . my3ql_errort) ): 
echo 'Connected successfully'; 
niysql_sel&ct_db ( $db ); 

?> 

<p>Here's the table data:</p> 

<?php 

$sql_stateiient = “SELECT * FROM cables”; 

$ results = inysql_query( $sql_stateiiient ) 

or printf£ "Query error; mysql^error() ); 

while ( $cow = inysql_fetch_assoc£ Oresults ) ) 

f 
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echo $j:dw[ ' cab] elD ‘ ] . 
echo » $tow['r!ELiie^l . 

echo $row[*lengthlnCni'l , 
echo SrowI'cableType'J ; 
echo “<p>"j 


iiiysql_cl ose { $1 ink ) : 

7> 

</body> 

</htjiLl> 

Save the file and reload it from Safari. Figure 4 shows my 
version of this run. Notice Uiat die data is lightly formatted, with 
a colon C**:'') after the item number and commas IxHween eacli 
of the fields, 

' lMy5QlT«t.; 

C jl 0 Sttg^ / /127^.0,1 m arit/ mtysgttest.php 

Coiujccting !□ the database. 

Cofuiccied ^cccssfuUy 
Bete's the lahSedaia: 

I;'Vaito DXIOOMOO, fhewire 
2: ’Gcnenco VT100\ 100* fiiewirc 
3: ‘GenenetJ VT50% 50* fuewim 
4: ’GciK^UlOO". I00*ysh 
5: 'PUaticor gSbony”, 20* usb 
6: "Plcxkor (Shorty % 20* fuewiic 


Figure 4. Retrieving the data from the database. 


Lets take a look at the code. We started witli the original 
code, connecting to and selecting the database. 

<html> 

<h€ad> 

<tltle>MySQL Test<7title) 

</head) 

<l>ody) 

<p>Cormecting to the database...</p> 

<7php 

$host = 'locaihost': 

Suser “ 'coot': 

Spw “ '*: 

£db = *products': 

$link = jnysql_connGct ( $bost, $uaer, $pw ) 

or die( *CouJ.d not connect: ' , !nysql_ecror{) ): 
echo 'Connected successfully': 

TJiysql_select_db( $db ); 

7> 



Next, we spit nut a line of HTML, preparing us for the table 
data to follow. 

<p>Hei:e'a the table daLa:</p> 

We lt)ad our ciuery into a PHP string, then pass the string into 
mysqLqueryO. This is tlie equivalent of lyping the string into the 
MySQL monitor as a query. Once again, we use tlie “or” opemtor 
and this time, instead of exiting with dieO, we'll display an error 
message using printfQ. printfO is derived from its C foifsearer, but 
is a part of the PUP library. As a point of interest, echo is nol a 


function, but Ls a language construct. You can use ech{> as a 
smiemeni, but can’t pass it as a function. Use printfO instead. 

<?php 

$£!ql„stateHient = ''SELECT * FROM Cables": 

$ results = inysql^qucry ( $sql__stateinein ) 

or printf( "Query error: %s"* ttiysql^errorO )t 

Next, we enter a while loop, using mysql_fetch_assod) to 
fetch one row' of the table at a lime. mysciLfetch_asscK:() returns 
an associative array, wliich Ls an array indexed by name iastead of 
by nuiiiLier, Instetid of $row131, you’d refer' to $rowl^cablerypeT 
AsfKx:iaiive arrays are one of my favorite parts of PHR Note that 
you could have also used mysql_fetch_row0, wliich would have 
returned a more tradition, numerically indexed array* 

while ( $row = inyeqLfetch_as30c( $results ) ) 

I 

For eadi row of data, we echo the fiek! value, intersperses! 
with colons, .spaces and commas. Note that we also make 
frequent use of the operator, 

echo $rowUcableID*] , 
echo . SrowpnflineH * . ", 

echo $row['lengthIriCiit'] , ", 
echo $ row [ ‘cableType'J; 
echo "Cp>": 
i 

Finally, we dose tiie database using the value returned liy 
inysqLconnectO, tlien exit our PliP area and return to HTML. 

raysqi_clQse( Slink ): 

?> 

</body> 

Until Next Month... 

Once again, seems we just get .started when Fve run out of 
rtjom to write. <sigh>* Your a.ssignment for this month is to first 
do a bit of research, then take the result of this niomh's query 
and build a nice ITl'ML table instead of just dumping the data 
using echo. On the research si<le of things* go to http://php.net 
and dig down through the PHP manual, looking up the various 
ftmclions we played with in this montlTs code. For example, 
here's a link to the page that talks about mysqljetch_assoc0: 
http://php,net/manual/en/fund:ion.mysql-fetch-assoc,php 
'Fake some time to get to know the PI IP documentation. YouT 
find it chfx'k hill of examples and incredibly useftiL Enjoy! © 

Jill 


About The Author 
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Welcome 

My typical work day Ls filled with intermprioa-^. 
Plioncs const^ndy ringing; pct)plu usking cjiiefiLinns^ etc. 
Everyone wants a piece of my time. Intentipdons are not 
only a major hit to productivity and effective time 
management; but when yoiiVe trying to replace a 
PowerBook logic board, it can mean bigger prol^lcms. 
'I'hey sometimes leave me wondering, ''Where did I set 
my screwdriver?", or "Where does this screw go again?" 
Now imagine having a secretary that ibilows you around 
all day recording w'hat you do. Whenever you Onish a 
task, it is scratched off a list; and whenever you start a 
new task, it is added to a list. Anytime you had an 
inteiTUj>[ion, yOLi couJd simj>ly ask your secretary wliai 
you were doing before the intemiption. That would be 
amazing! This is what Apple's software engineer’s were 
thinking when they introduced file .system jtRirnaling. 

Meet The Secretary 

To understand why file system journaling is 
important, we need to imderstand file systems ^ take a 
IcK^k at OS X system.s prior to journaling. File .systems are 
like library cataloging systems. Libniry catiilogs can tell 
you an exact name ik location of any lx)ok in the library; 
just like file systems can tell you the exact name Sc loaition 
of a piece of dam on a drive, l^oih systems regulate 
naming Sc location conventiotis for what they store. If a 
file system gets cormpted, it would be like trying to read 
a library catalog in a language you can’t understand. 

Journaling was introduced into OS 10.2.2 Server 
edition and into die client in 10.3, In previous OS 
versions, when you have any of these failures, they leave 
your sysiern volume in an unknown smte bec'ause there 
is no record of where the disk was internipted. The OS 
then had to do a data integrity check of the entire disk. 
Interruptions can also damage system files rendering the 
boot volume unusable. This is usually when you restart 
and are presented with a folder and the infamous flashing 


question mark because ihe computer can't find a disk to 
startup. Hut when journaling is enabled, the eompulLT 
tracks file system operations and inunediately logs them 
in a journal When restarting after a iaiiiue, the operating 
.system c:an use the journal to return the file.s system to its 
previous state. This eliminates tlie need to clieck the 
entire drive for inconsi.stencies. ln.stead, when the 
computer is restarted, it takes a look at its journal, reads 
to find out what it was doing, and pick.s up riglil where it 
left off. File system journaling is a major advancement in 
protecting the file system from ]X>wer outages, hardware 
failures, or software craslies. 

The Good 

A system continuity failure interrupts the read Sc write 
processes of a hard drive. These intenTiptions create 
discrepancies l^etween the file system (libraiy catalog) 
and the atmial location of the stored files (location of 
b(X)ks in libniry). In a journaled file system the OS has a 
record of disk activity, preventing the disk from tecoming 
unusable (most of the rime) which also prevents repairs 
that cost lx Jill Lime Sc money. It also cuts down on the 
time it takes to restaii the computer after one of these 
failures because the entire disk dex^sn't have to be 
cheeked for inconsisiencies block-by-block. Although a 
iiiLiiti-gigabyte hard drive only takes several minutes to 
check, the original idea in introducing file system 
journaling was to minimize down-time ff>r seivers 
because a multi-ierabyie disk could lake hours to check. 
A journaled file system takes just a few seconds to return 
to operating condition no matter what the size of the 
drive is. 

File system journaling was developed by Apple to 
be an extension to the current file system, 'i'his is good 
news because it lets you enable/di.sable journaling 
without reformatting the disk! The Mac OS Extended 
volume format C11FS+) can change between journaled 
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non-joiirnaled without any data ios^^. The 
advantages of this will become clear later in the article 
as we discuss reasons you may not want to use file 
system journaling. 

Beouse the journal works at the system level, it is 
invisible to the applications on the drive. Other than 
some disk utilities, all applications and network setups are 
compaTible with journaling. Most 3nl parly disk utilities 
will al.so work with journaling. Just in case you were 
wondering, finished actions are removed from the journal 
so the journal file doesn't become too large, just like that 
the .secretary^ crosses completed tasks off your list and 
throws them in the trash. 

Journaled file sy.stems are backward compatible 
with the regular HFS+ file .system.s. Meaning that 
compulcTs using an older Mac OS can have full access 
to journaled volumes. This is great news for external 
hard drive y.sers with multiple computers. That way 
you can use journaling on your Irard drive and all your 
Macs can use the drive whether they are running OS 
10.3 or an earlier version. 

The Not So Good 

Journaling doesn’t come without its cost, which 
liappens to Ijc performance. But fortunately, the 
performance hit only comes when the system is WTiting to 
the disk and not when it is reading from the disk. fVe 
never been able to actually tell the difference in speed on 
drives itinning joitrnaled verses non-journaled cirives. 
Supposedly, if you have a client version of the OS, the 
performance hit can be up to 20*^}, but the server version 
of the OS comes widi a huffered version of journaling. If 
you have enough iiAM, the server version is only 
supposed to take a 2-3% hit on hard drive performance. 

Here's my general oi>iniQn on two occasions when 
you shouldn't use journaling. If you have a drive that is 
primarily set up to l'>e read-only access, you don't need 
journaling. For example, if you have a hard drive that 
you keep your applications on (or just the OS), but not 
your acmal documents or working files on, then you 
probably don'i need file system journaling, Tliis is 
because you are just pulling data off the drive 99% of the 
time and are rarely saving data back to the drive. If your 
system fails, your drive probably wasn'l in the middle of 
writing data. Or if you have a file server disk that is 
always under heavy speed demands AND you back it up 
on at least a ckily basis, T would consider disabling file 
system journaling. This might be die case if you are 
storing large data files containing audio or video that are 
accessed frequently. 

Although file system journaling will help you save 
data that has already been journaled to your drive; you 
may still lose data in the event of a failure that is in the 
buffer before it i.s written to the drive. So file system 


journaling definitely needs to be complimented by a 
battery backup system. 

I1ie last drawback to consider is the failure of some 
3rd party disk utilities to work with file system journaling. 
Make sure you check compatibility on a manufacturer’s 
website before using a 3rd party utility on a journaled file 
sy.stem. Many of the vendors released updates 
specifically ft>r their product to work wiili a journaled file 
system. IVe heard nightmares of [Deople losing al! their 
data by ainning an incompatible disk utility with a 
journaled file system. 

File system journaling has its limitations and is not a 
fix-all answer to your data problems. According to 
Apple, file system journaling is one of several measures 
you should take to avoid data loss. Fife system journaling 
should be coupled with RAID (redundant array of 
indexed disks) stomge, a continuous backup strategy, 
and an uninterrupLcd power source (UPS) for maximum 
protection of you digital assets. 

Enabling/Disabling 


You can enable or disable file system journaling 
using Di.sk Utility (located in the Application.s/Utilities 
fidder). Select a volume in Disk Utility (figure 1). 



if you want to enable journaling, you can simply 
click 'Enable Journaling’ from the pane. This will enable 
foumaiing without erasing data on the disk. If you/d like 
to disable journaling, you can select the volume and then 
click File-Disable Journaling from the menu ban 

You can also enable or disable file system 
journaling using the command line version of Disk 
Utility, diskutil. To have sufficient privileges you'll 
have to use siido (super user do) with diskutil. To 
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enaljlc fife syHlctn journaling on Liie root tlireciory 
type: 

Slide diskulill enableJournal / 

and then type in your administrator password. If you'd 
like to disable file system journaling on the root 
directory use: 

sudo diskutil disableJaurDal / 

followed by your administrator password. 1b enable or 
disable on volumes other than the startup disk replace / 
witli /VoluniesAVokimeName), 

Repairing Journaled Drives 

I'o repair an ailing journaled drive you can once 
again use Disk Utility. The Irick is that you <::ani repair 
the disk you booted frcjni; so if you want to repair your 
startup volume with Disk Utility, you have to staiTup to a 
CD or another drive. Once you iiave Disk Utility open, 
select the drive that you want to repair and then click 
‘Repair Disk’. If you <.lon1 have another drive you can 
staitup from you 11 be iTetter off using a 3rd party utility or 
the command line. 

If you don't want to spend the money on a 3id 
party disk utility, try using the command line utility 
fsckjifs. To fort'e fsck_hfs to check a jcnirnaled 


volume you need to use the argument T, Also, if you 
just want to verify status of the drive, use the -n flag; 
but if you want to repair the drive, use the -y flag. 

There are a number of excellent 3rd party disk 
utilities. My favorite are Disk Warrior X 8t. TechTool Pro. 
'Ihere are also a number of shareware ik freeware 
applications to be found just by searching 
versiontracker. com or macu pdate .com. 

Wrapping up Journaling 

Usitig file system journaling is a great idea for most 
users. 1’here are the cx^casions to disable it, liut for the 
most part it makes our lives easier. Thai is where the 
analogy leaves the library catalog. Pile system journaling 
is done automatically, but looking up a book in a library 
can sc:)nietimes be challenging. T’ni just glad file .system 
journaling keeps track of everything withcjut my lifting a 
finger. But remember, file system journaling does not 
excuse you from needing a regular system backup! 

_ 
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THE SOURCE HOUND • by Dean Shavit 


Business Unusual: 
Open-Source With Teeth 


D ear reader, if you’ve been reading the Source Hound, you’ll 
know that I’m a big proponent of Apple’s use of Open Source 
in OS X as well as using Open Source software to enhance the 
OS X experience. You might think that I’m a bit unusual in this 
business, but I do have a kindred spirit whose passion for Open- 
Source has taken him out of the comfortable confines of a writer’s 
office, to directly into the line of fire. The person I’m speaking of is 
Michael Bell, a.k.a Dainkenbatman, (we’ll call him DBM for short), 
proprietor of Dmnkenblog (http://www.damkenblog.com), a we!) 
site which has raised more than a few eyebrows by its rigorous 
defense of those targeted by Apple in tlie Tiger leak lawsuits, in 
which even Steve Wozniak weighed in with an email to 
Dainkenbatman as well as 25 other major Mac developers. 


Taking a Bite out of Open-Source 


Iiditor's Note: The followin^f 
discussion louches 07i many 
conlnwersia! and polentiaUy 
sensitive areas. We want to make 
it dear to our readers that, while 
we find this discussion 
compeiiing, enlightening and 
important, the opinions 
expressed herein are those of 
Michael Bell and Dean Shavit, 
and do not necessarily reflect the 
opinions of MacTech or its 
parent, Xplairt CorporatiotL 


Most recently, DBM has spent htindreds of hours 
deconsiructing a software cf>mpany called Maui XStream, 
and iheir Chen 70 S product. Ilis investigation into Maui 
XStream is borh interesting and rechnically enligluening, 1 
encourage MacTech readers to check it ouD As you will see, 
DBM has declined lo lalk directly about the ClierryOS/Maui 
XSircam situation. 


h the Source Hound (I'SH) had :i virtual sitdown with DBM 
(over iChat) to discns,s Of)en-Source software (OSS) intellectual 
property (IP), and otlter issues as they relate to OS X and OSS 
in gcnentl, Wliile we agreed on some points, we diverged on 
others. One point we Ixah agreed on i,s iluii die world in general 
and OS X needs OSS, and drat OSS transcends the interest of any 
one company, person, or platforrn. 
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Drunkenbatman in the House 

DBM: drunkenbatman in the house. 

TSII: Just a little background to get things going. 

DBM: is this going to tie verbatim or cleaned up? 

TSH: T11 dean it up with yemr appmvaL 
DBM: wOOt 

TSII: IVe been reading your blog “Drunkenblog" 
http://www.drunkenblog.com for a couple of years now 
A.nd IVe liecn ania/ed at the steady progression of effoit that's 
l:>een going into your articles. 

DBM: UrOj are we doing the interview right now? Lol you liave 
to say go. 

TSH. OK, let me get u.s warmed up, gd flow diti you get started 
with Drunkenblog, why Drunkenbatman as an identity, wliat 
about the cow? 



Figure 1. The Drunkenblog Cow 

DBM Erm, its a little weird to me that Tve actually lieen doing 
it for a few years. There’s kind of a ait-off point between when 
people were actitally reading, and when I actually had it up. I'd 
have lu cheek, but 1 think the first ptisl is “So, I’m doing this 
because everyone is and yoo’re supposed to, but don’t really 
know what to say^ anti then a month of nothing. And then a 
terminal tutorial or two, and then things started to go bang. Back 
tlicn, it was originally DrunkenBatman.com, because I used the 
nickname 'drunkenbatman' on a lot of places I hung out. 'My 
Blog’ sounded lame, and so did 'Dnin ken batman's Blog’. Then 1 
got a weird letter from Time Warner, and while they eventually 


lrac*keci down, 1 decided it was gfxid to pick u[i 
DrunkenBlogxom and here we are. The Cow is just tliere 
because it cracks me up. Are you asking if 1 actually drink 
while I write? 

TSH: No I don’t think you drink w'hen you write. 

DBM: But I do sometimes. If you check the time stamps, 
Tm often posting at 3am or Sam, so you often need things 
to keep you awake or things to settle you down. You can 
generally tell when IVe rounded the horn with the rum 
during tlie making of a post, as typos go way up. 

TSH: I know how hard it is to write interesting, well- 
researched technical articles, so 1 am sure you must be 
sober the majority of the time. So run-ins with lawyers are 
nothing new for Drunkenbatman? 

DBM: TlieyTc pretty new, and the thing with Time 
Warner w'asn't really a big deal. 'I'hey just wanted the 
domain, and 1 had to explain ihai for a variety of reastms 
that wasn’t an option, and they agreed to walk away as 
long as 1 wasn't using it for anything commercial, 1 can 
kind of get where they're coming from — they might not 
care that much al>out what Fm doing personally, but if it’s 
their tradetiiark and all, they have to defend it or they can 
hitve problems when someone starts hurting the iinage of 
their “heroX 

TSH: You liad incnliDnod a while ago tliat you came from 
the user interface side of the computer business, bur for 
some reason, reading Drunkenblog convinced me dmt 
you were a developer. 

DBM: Yeah, that is a misconception 1 get a lot, which is 
actually Idnd of cook 1 can certainly c:ode some, but no I 
wouldn’t call myself a developer. 

1 tliink a lot of that misconception for people is rooted in 
the fact that 1 know a lot of technical things, and abtjul 
the developcT side t)f the proces^s of cirating software. 
And when you’re making an application, there are 
ceitainiy sides, even though someone might have lo be 
wearing muUiple hals. 

TSH: You know a whole lot about OSS (Open-Struirce 
Software), as much as anyone IVe spoken to. How would 
you chanteterize your role in the OSS great chain of l)eing? 

DBM: God. 

Or a minnow. Sorta depends on the day. 

Lol sorry. Urn, can I a.sk why you Ye asking? 

TSH: I want you to tell me if you're a hobbyist, journalist, 
aficionado, spy, etc. How do you characterize yourself? 
DBM: Honestly? Reluaant poster Ixiy for a whole slew of 
causes. When it came time to do some interviews, 1 ended 
up deciding that a lot of the coimtiercial guys are good at 
getting their name out, and I wanted to pick people who 
were .slaving away—lhcy don’t generally ask for money, 
but mayl^e i could shine some light on tlie kick ass work 
they’re doing. 


^AAcaat 


The Source Hound 


19 




















TSII: You know that's exactly what the SoLirce Hound Column 
is all a hour, bringing attention to Open-Source projects! 
HoweveTj youVe the firsL inler\aew I’ve ever clone! 

DBM: So. . . CherryOS came about because Pieter Van den 
Abeele, the head of gentocKill (they do gentcx) macosj gentoo 
for powerpc, cLc j forwarded it onto me. 

TSH: The amount of effort you put into researclting ClierryOS 
was a.stcmishing. 

DBM; It was an off-thecuff email from one of the developers 
where he asked “what's this about you getting ripix‘d ofr\ and 
he ju-st thought i could maylx do something to help, since I'm 
known for pulling together some big things 
TSH: Big things such as. . , . 

DBM: 1 had Steve Wozniak give me a quote for the site and 
rwentyd’ive plus other big-time Mac developei's. None of that 
happened by accident, 1 went to all of them and asked. 1 knew 
Woz from ages ago in a minor way; then I took his quote and 
went to the others. 

TSH: Your technical knowledge seems eclectic and granular, you 
sprinkle your articles with it, adding Oavor. Wltere does tliis 
knowledge come from':' Is it part of your day-to-day work 
envirtmment? 1 was a big Mac‘ fan even IxTorc ihe OS X days, 
how' alxjut you? Are you willing to date yoursell? 1 am! 

DBM: Loi, that's a lot of questic^ns at once. I know' a lot of things 
t don't say, t>iit a lot of it just comes just because it's something 
1 luifopened to lx interested in and went nuts researctiing. And 
really, when it comes to technology, it's like Mark Tw^ain said: 
'1-iistory doesn’t repeat itself, hut it rhymes," There are patterns 
in most of what w^e use, and once you grok the patterns, ytni 
can have an idea of how things will or could go. For example, 
a lot of the technology we use right now is really an extension 
of stuff that was around in the 70s and 80s. You pull someone 
here with a time machine, anti iliey'll understand the algorithms 
and equations being used, even if they didn’t have the 
horsepower to use it as pen^asively a,s we do. If you grok one 
protocol, you usually have the t>aUenis in the re.sL You grok one 
object oriented programming language, and you know' the 
patterns of what’.s up the othei's, the rest is just inipiejnentation. 
TSH: Of course, it's the same with scri[)iing languages. A loop’s 
a kx)p; if yoiiVe seen one subroutine you've seen iliem all. . .bill 
Fill more interested in finding out how^ you came to write alxjut 
OS X and the Mac. . . 

DBM: As for dating inyxSelf, my lirsi Mac lliat I actually twned 
was a Quatlm 660 AV. I loved that machine, and hs\ 
approximately one man-year to playing Bungee's Marathon. I 
loved that madiine. It wxs so starkly different from anything else 
on the market at the time that t!ie only thing I had to lust for 
were some of the machines SGI was putting out, or its big 
l>rt)iher, the 840AV, FI! never forgive Apple for the GeoFort, but 
I loved that machine. 

TSH; Yeah, I had a Geo[X)rt telecom adapter too, it wasn't one 
of Apple’.s best efforts. . . 

DBM: I started using Macs because our high school used them 
for tlie schoi:)! newspafijer, and ! was really interested in tlic arts 
at the time. I had a really supportive family, and my dad 


basic^aily used his c*iirnings frt>m his summer job to pay ftjr it, 
wliich was a really big deal. If I recall, it was about $3^300 with 
the monitor, plus the GeoPon adapter that shipped over 6 
months later, which was a huge dtunk of cash to lay out for a 
kid in his bedroom. 

TSH: OK, so now having dated yourself, Fm going to hit you 
with this tjiiestion. . . Du you remember COS? 

DBM I m not the best with acronyms. COS? CherryOS? 

TSH: Not CherryOS, but a predecessor, lx)th in opaciry and 
form. . . CryptoOS. 

DBM; Lol, no, I honestly can't say that I do, although tlie name 
sounds familiar. Emulators in those days w^ere hardware cards 
you'd skif) into your computer; even Apple was selling one. Was 
someone trying to do it all in software liicn? 

TSH: Not ex;ictly. It was a hoax perpetrated by some folks in 
Germany, who claimed they'd written a new OS for the Mac that 
was eiicryq^ted throughout. This was witen we were waiting for 
Copland. 1996 or so. 

DBM: Ob ws, \ do rememlx^r them. 

TSH: 1 rememlxT they kept it u[i for t|uite a while, until one 
day, they actually asked on their website for a copy of Copland, 
they soon disappeared after that. 

DBM; Tliey never actually produced anything—it was all just a 
prejvs release here and there w'itli a simple website, rigliL^ 

TSH; Yup, they generated a lol of buzz. We were so desperate 
for .something ‘’new" for our Ma('s, that we wouklVe taken just 
about anything that wasn't System 7.3! I ctxildiVi help but make 
some sort of strange conneition between COS of the 1990s and 
the COS of 2004 and 2fX)i! 

DBM: "grins* t acuially think hoaxe.s are kind u\~ cool Un just 
that reason. They can show what we w'ani to believe. The One 
line between a hoax and a fraud is when they’re asking for your 
cash. 

TSII: Ah, that is the line, isn't it . . .so it seems our Mac lives 
intersect .somew'hat, though 111 have to admit that the computer 
I used in High Sdiot)l was an Apple 11, and it was brand-new. 
DBM: Hey, 1 used an Afjple 11 in sdiot)I Loo, because tjur sdux)Is 
weren't really roUing in it anti once you have Nuinter Munchers 
you’re really ju.st adding nicer graphics. The nice.st computers 
were in the media lab and newspaper, which were primarily LC 
il's and Ill's and one Quadra. Oregon Trail, all tlie way. 

TSH: Do you w'ork in a Mac-related field now? 

DBM: No, [ don't really work in a Muc-relaled field, 1 just try to 
work in fields where what I'm using doesn't matter. 

I'SH: I'liaFs really ea.sier said than done, so Fm guessing that 
you must a writer or w^ordsmith of some .sort. 

DBM: In some ways, it gels harder and harder as time goes on, 
even if ifs not a fun subject to talk about. 1 have friends who 
do nothing but web work, which you'd think would just require 
a text editor and web browser, and at worst ViruialPC in order 
to lest stuff in IE for Windows. Ilowever, it's all those little 
veitical apps that just kill you. You'll be coasulting Ibr someone, 
and they use .Source Safe to version their axle, which has no 
Mac client to speak of, so ytru're just screwed.! guess what Fm 
trying to say is that what I do for a living isn't that important. 
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TSH: So some of your passion for 0[)en-Source Software is 
work-relaietl? 1 know mine is an outgrowth of wanting to avoitt 
ihc verticals you mentionetL 

DBM: A lot my passion aboui OSS cx>nics from using and workijig 
wifli the apps, and 1 was originally fasciitatcd hy the idea of 
giving your work away. When yoti consult lor sotneont:, 1 think 
your jol7 is to do what's best for rlie efienn even if tliat niean.s you 
end up picking up a I*C. 1 don't luive any [iroldem with j^eople 
using Window's or IcKking themselves in, even if it annoys me. 
TSH: Interesting. ■'Giving it aw'ay“ versus "sharing/' T!iea''s a hig 
difference there. 

DBM: Yes, there is, liuL wheti 1 first got into it, like niost, I didn’t 
really gel wlial was going on, All I knew was you couki 
download this stufT, and the source, and use it for free. 
Peripherally, I knew there were things going on with MySQL 
and KDE that were causing a stir, but 1 wasn't really aware. Ami 
iliat's proliably most people's exposure to Open Sourte. They’ll 
I'H^ using something proprictar>', and something comes along 
that’s Tree' so lltey download it and use it. Sometimes wiiat’s 
■free’ is acaially better than what’s proprietary. And then tliey're 
not making exaises for what tliey’re using to save a buck, so 
diey become loyal. After a time, they miglit even Ix^corne a 
iK-lieven My passion for it now is primarily for praiiical reasons. 
We need sotrware. Lors of it. piles of it. Morc‘ j)eoj>le are Ixing 
Ixirn than are going into prognumning, and while new coding 
paradigtiis and tools can act as force jnultipliers, we need to 
improve what we have and create new tilings. More and more 
often, those new^ things are l>eing Ixised on OS.S, i>ecause 
n.‘inventing Lite wheel just gets old. 

TSH: In my opinion, free Ls alwii)^ ixtter tlian propriela^y^ It inakc^ 
me a little ill to see scjftw^are l)eing sold (even In the OS X domain) 
that isn't as gtKKl as die OSS alternative; Yet many fintl a comfort 
in paying for it, even if they know' they shouldn't, HI agree lluit 
we’ie goijig to neetl more software, but we aLs<j neetl pix>ces.ses 
and ([uality c'ontrol and testing and new meaas of version onirol 
and intern]xralality. Tlie wdieel Is really all we have right now, it’s 
often alxHit the hulxabs and how shiny tliey are. , . 

DBM: *grins* Many people have that opinion, but there’.s a 
difference iKlween proprietary and free. I don't have a prol)lem 
with closed-source software, but 1 get entirely annoyed at 
software that locks you in. Our data is our life, and I’ve lost 
count of the a]>ps dial Tve Ixmght that died and all that data was 
locked away w'ithin them, liecause 1 couldn't upgrade the app 
when there was a new OS or something. And yes QA (Qualit}^ 
A.ssurant.e) is ceitamiy in real troubie, and yes much of ti comes 
from companies having to meet the reqiiimmenls for the 
quarter, but those types of things cxime up in OSS too. 

For example, pressures are just often more indirect. The more 
users you have, the more things they want, if you chotxse not to 
put them in, you run the danger (if your app Ixing forked, ilell, 
you jttsi may need to gel .something out l>ecause you'll be going 
on vacation. One OSS app 1 know rushed a release a bit more 
than they probably sliotild have, jusi [>ecausc they wanted to 
make the deadline for Aj^plc's awards ai WWDC. 

But really, much of the great software 1 use is ’clc^setl .source', 


hut none of it is proprietary. Most of the great RSS readers are 
ckxsed source, but they can all import and export your data. 
TSH: OK, we have slightly different deft nit ions of proprietary. 
DBM: Brohably. Bui hey, why do you use a Mac? It's 
proprietary, yes? 

You c:ouid pick u]> an Xi86 and run Linux and knew everyiliing 
there, with the exception of pediaps a vidt^o driver, Ls Open Soune. 
TSH; I'd me. proprietary means “closed source** and not 
neces^sarily ()n)prietary in the sense that the data can t migrate 
out of the app. I've Ix-en over that ground before in niy 
columas, 

DBM: Ah, riglu. You’re talking aiKJUt formats primarily then. 
TSH: Basically, I do Ixive quibble^i with some of Apple’s 
proprietary practices, especially in the area of QuickTime and 
Fairplay, Also in tlie area of liardware that’s imsupported by OS 
upgrades. 

DBM: And tlieir ROM? 

TSH: 'llie ROM is a sword lhai cuts (xnii ways. At least there's 
lt^s.s and less of it now. Man, who’s wagging whf^ here? 

DBM: Yeah, some of those situations are a liule unctxil. Apple 
and what they do and don't supfxjrl isn’t helping their warm 
and fuxxy image. Wagging is fun. Share. 

TSH: Welt let's just say that I'm on the record as supporting OSS 
on OS X and .Apple Hardware for several reasons. First, while I 
am c:omforta[)le witli Linux, I prefer Apple finrelwafe and the 
consistent GUI that OS X offers. Like yourself, I grew' u]) on 
Apple hardware an<l the Mac, lht:n made ii iny i>rofessional 
choice. 1 think OSS on OS X offers the l^est of both worlds, a 
cliche, I know, but it s really true. And the degree to whidi they 
protect certain things is re^illy silly, especially when it comes to 
the lawsuits over the Tiger “leaks” you WTOte alx)ut, , .of course, 
ix‘ing a developer. I had I'iger, but dkln't see whai all of ihe Fuss 
was alx>ul. In some respects, I think a lot of il Ls siuoke-and- 
miiTors. Today, I'm using Tiger and It’s great, don't get me 
wrong, a real advance in many ways, but like yf)u .said, some of 
the QA has gone out the window and it makes tue wonder if 
the lawsuits w^ere just a way for Aj>ple to let tlie world know 
"we've got .someihing really gotxl, and it’s a secret/ 

DBM: 10.4 probably never should have shipped in ilie state it 
w'as in, and most people know it. Tlie fact tliat some real 
hardc'ort* Mac people are making some rumbles is telling, as it's 
starting to freak some people out. llie milh is, 10.3 never 
should have shipped in the siaie it was in eitlier. Altnosi 
every^ine w'ho wax a developer was saying “Itiis is really going 
GM? My grxl, this isn't ready," yet ship it did. Anti then it blasted 
data off of people's Firewire drives, and FileVaLilt Ls still one of 
the .scariest and flakiest tecimologies around, 

TSH: FileVault is actually pretty simple. But t know w4iat you 
mean. Well, quality assuranto issues aside, it was die "secrecy” 
surrounding 1'iger iliat irked me .somewhat. I mean, I'm a Select 
AfXl ineml>er, I've paid a fee, and when it went GM, I couldn’t 
download the GM build until the night Tiger wa.s njlc^ased. 
There were some real surprises wailing for me toot Anyway, 
we're getting off tOfjie. 

I wanted to explore proprietary v, OSS, 
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OBM: Understocd. So, let me swing fyack araund to why 1 ft>vc OSS, 
Mac OS X really shows off exaaly why tVe fallen in love wiili 
OSS, LLS tlierc's an old expression “Standing on the shoulders of 
giants." I doulDt we'll see another major kernei rewritlen in our 
lifetimes- Apple proved they couldn't even really do it, at least 
not wiili the current management and requirements they had. 
Copeland didn't just die, it fell on iLs sword spectacularly. In fad 
the only kernels we really have, miims someiliing like a PDA, 
are Tron, BSD, l.tnux and 

Now that software is at the level it is, the cost of just improving 
what we have is so large that to start from scratch is becoming 
more and more of a non-starter, for both OSS and closed-st>yrce 
software. In a lot of die clcxsed-source siulf, ihis comes in the 
form of libraries Apple siiips with rtxilines developers can draw 
upt>n, because it's just stupid for every developer to have to 
unplement s[jelt<iiecking. However, more frec|iientJy it might 
well be an OSS library too, and Apple may well l>e incorptiraiing 
an OSS libniry when it doesn't make sense for them to reinvent 
llie wheel. 

Even the i>est OSS stuff we have is often built on shoulders of 
giants. An example might be AdiomX (www.adiujnxxom) or Fire 
(fire-SOurceforge.net), where they wanted to create a kick-ass 
native chat client for the Mac. If there wasn'i an OSS .solution 
available for them to draw' on—LibGaim— 
(encyd-opentopia.com/term/Gaim) we'd probably .still Ix" waiting for 
the first version to he released- Bet.-ause it was there, they were 
able to write a smaller percentage of new code to do whai tliey 
needed, and their eflbns were multiplied by the available 
library and the fact that they tlkln't have to reinvent the w'heel. 
TSH: Aren't you forgetting Macli in your list of kernels? 

DBM: 1 am of sorts, but Mach would be pretty lame w itliout tlie 
BSD Liserland, so 1 just sorru luinp them and liSD togetlier in my 
head, as minus a few weirdities it feels like BSD to a user. .Still 
out of all of them, if‘we're not talking alxmi handliclds and such, 
NT is really the only major closed-souae kerne) around, and I 
doubt tJiey'll lx rewriting it anytime soon, especially since they 
were smart at the beginning and made die code very p<mal>le- 
TSH: Who are the giants in the OSS world now? Which projecls 
are the ones to keep an eye on, especially for OS X users? If 
youVe been reading my column, you’ll know ihat Patrick laiby 
is cerUJinly at the top of my list- 
DBM: Whal project is Patrick Lul^y on? 

TSIl; NeoOffice/J (wvwv.neooffice.org)- 

DBM: Oh my gawd- Dull, I have an email from hiiu in my 
inbox, that's how far behind I am, I feel so sorry for that guy- 
Many jxople have fatten off more than they can chew, but he 
and his partner really have the proverbial elephant. It's literally 
like two guys and 300 megs of code. 

TSll: Why would you feel sorry for Patrick? He and Ed Peterlin 
are really tlie only ones wlio are positioned to do what they’re 
doing. Patrick used to work at Sun on the OixmOlTce Project 
and is a J2EEE wizard. 

DBM: Simply Ixxause of tlie retjuirements they've put on 
themselves to do what they're doing—it's a Herculran lask. 
Absolulely Herculean. 


I'SH; I think what theyVe done is spectacular. Absolutely 
.spectacular. If Apple isn’t paying close attention, it should, if 
tliey don’t win sometliing at WWDC, HI lx very very sad. All of 
the luicks that make NeoOffice/j work should be codified as 
libraries for XCtxle. 

DBM: Tliey have a project with a massive code base, doing a 
ton of interrelated things, that was [nost certainly not intended 
to lx on a phitfomi like OS X, so the amount of work they've 
set out for themselves—Uieir final goal—would take a team of 
20 a year to complete if not more. And they’re two guy.s, with a 
project so large only they really understand it, so few people are 
willing, let alone able, lo roll up I heir sleeves and pitch in. 

'I'he biggest 'projects' I keep an eye on are the ftirce-multipliers, 
which have a way of sneaking up on you. Grow! (growt.ififo) is 
a very good example of I his, which I’m keeping an eye on for 
a few reasons. 

TSH: IVe done the best 1 can for NeoOfflce/j from the sidelines. 
Rah rah rah. If Patrick and Ed cotild 'Ixittle" whal they did, it 
could bring a lot more applications to OS X. 

DBM: If youVe never heard of Growl, it's ba.sically a unified 
event system for Mac OS X- You can set any up to throw its 
message.s ihtxiugh it, insteail of bouncing the dock or throwing 
up an alert. It's like the iChai bubble, except it fades away, so 
you don’t have to switch to your mail client ju.st to see what the 
new message in your inbox is. 

I’SH: Yes, I know^ what it is, but as far as OSS gc>t‘s, it’s for OS 
X only. 

DBM: U’.s a really valinible .service, so it won't ,siay OS X only for 
long- I'm told otliers are kxjking at implementing it almost vediatim 
on other platforms, as [X'ople are really digging iL They've gone 
from 19 apps supporting Cmml when I first talked to tliem to over 
120- Pct)[>le like Sk^'pe are dropping in .support, now. 

TSH: That'.s certainly going U> help! 

DBM: One of the things that fascinates me is what a fortr 
multiplier it Ls- Here's an app showing a great service that 
people love. Nonmilly, those 1(B+ apps would all have to 
implement tlieir own, instead they all gel ilie functionality by 
lying into GrowL If it was closed source, they proliably wouldn't 
have their app de|xmd upt>n it unless it came from Apple, and 
Apple doesn't have an>ahing like it. 

TSH; OK, so a shared lihraiy=force multiplier in your view? 
DBM: Well, all OSS code is a force multiplier in the sense that 
someone is saving rime by using it instead of reinveniing ti se wheel- 
In the c^ise of OS X it's iheij- kernel and oserland. the CIJ stuff, and 
in the ca.se of Grxm'l it's a way to threw messages on die screen. 
It’s actually ingrained into tlie idea of OSS, and why we have 
liceases like BSD and LGPL iastead of just the GPL. Tlicrc are 
cases where it jusi kicks ass if more people are using something 
than If tlicy aren't, and if the TCP/T? stack wasn't BSD, who 
knows what Miao.sofl or Apple would have used and how 
screwed up it could have made ihings- 

Anollier thing I think is notable about Growl is how their 
developer system is setup, and I'm kind of fascinated to see 
how it’ll work out as it contrasts to heavily with say, the 
NeoOffice/J situation- 
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lliey have bounty of help, well over 20 developers from various 
oifier OSS projec’Ls, all pkehtng in on this one service doing 
tilings tliey want to see in it beta use tlicir app will i>e making 
use of it. Normally in a situation like this, tliere's a tendency to 
go ro lead developers, choke points who keep what goe-S into 
tlie softw are sane. Tliey l>asitaily oy:>Lcd for a different approach, 
width is practically socialism in development with no real “tick’s"' 
going around. 

TSH: Growl is interesiing to me in the sense that it was never 
intended Uj lie an Apyditalioii, but an extension u> otlier 
applications. Sort of like the OSS vei-sion of an OS X Framework. 
T wx>ncler what wcxiki happen, say, if Apple open-sourced one of 
their Frameworks, like Coreimage. 1 wonder if ilie code would 
lend itself to picking up by others, or would be considered a 
proprietary^ mes-s. It’s an iiiteresting hypothetical question. 

DBM: Pnjixtbly a Utile bit of IxHIl I know a loi of the KHTML 
developers are not big A[:)]>le fans riglii now, or rather UieyVe very 
annoyed w'itli parts of the fan base w^ho have the wrong idea 
alxuii I heir reladonsliip with Apple am! Safari. One of the biggest 
j:iroblems wirli anyilung like tliat tliough are [>rior tonsidenitions. 
TSIi: Much of the same speculation’s revolved around the 
.source ccxle for HyperCard, which people have been asking 
Apple to release. I say ‘lie careful what yc^ii ask for, you just 
might gel it," 

DBM: Most of the licenses out there require you to give up the 
patent rights to whatever you release, so you can t start beating 
people over the head later, and tliere could w'ell [>t‘ things Apple 
doesn’t w ant to give up. And truth lx- told, you never know wiiai 
Apple actually owms. What Tm saying is, Apple just might nor 
really have the o[ition wdfi some of llieir stuff If we go Ixick and 
look at NeX'I', ApfDie was using Display Postscript for their 
display layer, which they'd licensed from Adolx. Assuming 
NeXT warned to o|m:n SfHirce their OS completely^ I am giting to 
assutoe NeXT would liave liad a hard time getting Adolte to 
allows them to Open Source their Display Postscript stuff 
TSH: Well, yes, it’s w'klely known (and even trumpeted by 
Tiger itself) that OS X (and QuickTime 7) contains royalLy- 
Ixaring technologies. 

DBM: Yes, lhai it does, many of tliem surrcuinding c'cxlecs, 

But most of A[:)])lc'.s software is a black box. We have no idea 
what's really in it, sij we can’t assume that there’s nothing in 
Quart?, they haven’t licenseci from other companies or don’t own 
the patents to, so they can’t give it away. 

TSH: The “Black Box" analogy of Apple’s software is more than 
a little interesting to me. In yoiii’ recent deconstruction of Maui 
XStream's CiienyOS, you used various techniques to compare 
memtjry dumps of ClierryOS and PearPC (http://www.pearpc.net) 
to prove your case. 

Of course, knowing in advance what to look for made your job 
that mudi easier. 

Yet if we were to apply the same techniques to OvS X. or 
Windows 2003 Server, and had the luck to know what we were 
looking for, do you tliink eitlier would come up clean? 

DBM: ITxI [ike you’re treading on dangerous waters? *grin* 

See^ here’s the deal. Companies like Apple and Microsoft are 


basically Incoming intellectual property companies. It’s their 
lifeblood now, it’s just everything. People tlhnk of Microsoft as 
not t)eing veiy' inutwalive, but in some ways dial’s old-schtK>l 
thinking, and doesn't take into account just what they spend on 
research and just hc^w' many patents and such they're pumping 
out, and it goes I he same for Apple. 

TSH: Maylx. However, Ixfore I went into the computer 
l:)iisiness 1 wanted to be a poet. 1 WTOte poetry, and studied for 
my Ph.D. in creative writing for six years. You read other 
tieople’s ix)elry and you read. And you foi^et it, but it creeps 
into your writing, T.S. Eliot once said, “bad poets laorrow, great 
poets steal.” 

Now you can gel away with that in the arts. Yt>u can hear an 
echo tT someone else's voice inside your writing and often 
tliat's desirable, yet there’s no mechanism to make a byte for 
byte comparison of ihai, in the software bijsines,s, there is. 
Especially wTen you know what to look for. 

The reason 1 guess I'm bringing this up as Apple and Microsoft 
rigorously defencl their IP, is the question of how well tliey'd 
fare if put to Lhc metal? 

DBM: Right, and there’s that element, but not here. Their IP Is 
their treasure-chest. T'heii’ current product might die, but their 
IP is what they live and die Iiy, ajid to endanger that would be 
the lieighi of siupidiiy—the poieniial cost is just not wonli the 
risk. People say tliat the GPL has never been tested in an 
American court, bur it’s written so tightly that no one wants to 
iry. And die larger the company, ihe larger the payoui. It's hard 
to go after small to mediujn l>usiness, but law^yers start smelling 
dollar signs when you hit multinational and the words class- 
action are used. 

TSH: Yes, the CPL’s a work of ‘'.spare genius” (quoting mysein 
If tJiere was any type GPL code in their product, and it was 
proved, who knows what would happen or w^har they'd have to 
do t)r how^ devaslaling it could lx. They coukl lose all the 
patents that are in it, so there's just no point in taking that risk. 
DBM: Now, you could well find code if you knew exactly 
where to l(5ok, hut it probably wouldn’t lx? what you think. 
TSH: There's no way that Apple or Microsoft can control their 
code that clo.sely, All it takes is c^ne laxy programmer that wants 
to make it to iheir .son’s baseball game, and it’s in there. No one 
is tlie wiser. OSS is so prevalent, that it has to get inside some 
programmer's head. 

DBM: Exactly, and that's pretty much where i wa.s going. If a 
programmer has a prohlent or deadline, and access to Google, 
they may well come across a function or algorithm somew^here 
and drop it in and no one is even aware, lliat stuff is going to 
iiaptien, sure, and ihere miglii even lie some {'ommonaliiy to it, 
!:ait it’s not the end of tlie w^oild. 

TSH: I Iiave seen enough of ligei to know' that Apple isn’t 
spending a w^hole lot of time scrutinizing every aspect of ks 
own work. Tiger changed the output of diskuiil and 
system_profiler, for example, which broke some of my scripts. 
Really the question in my minci becomes how many 
pro[)rietary software producLs could stand to be scrutinized the 
way you scRitinized Cherry OS and pass the test. 1 wonder 
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how annnum it is to a>hble together OSS code and sell it as 
your own, 

DBM: I ain't talk spedfiatlly akiul CherryOS and such, Ix^cause 
of lawyerly-thin^, but while 1 think its a gcxxl question the answer 
always comes down tt>: quite a few, but rarely anything big. 

*rSH: If, for example, I were tlie CIO of a corporation, and 
someone came to me with a streaming video solution that 
worked cjuile well, and priced welf could I safely assume that 
it wasn't a fraud? 

'Ibis seems to me to be the biggest question your ClierryOS 
investigation has spawned, at least in my mind. 

DBM: Right, 

I'SH: ,Shouldn‘t software lx? "‘chec'kecl out'' tjcfore it's Ixiiight or sokt' 
And who is going to do the checking? 

DBM: If it wem [uc, one of the things Td kK)k at was how well 
the software was known. This stuff doesn’t really (Kcur in the 
mainsiream, simply l>ecause someone has too much to kxse and 
it almost always end up coming out if someone mainstream tries 
it. As tlie ex[xxiure of an app goes up, and people liecome 
aware, theyH get suspicious if things aren’t on ihe up and up. 
TSH: I'm going U) WWDC tn a couple of weeks, and Til l>e 
surrounded by tnany folks who I admire from the OSS world 
while simultaneously surrounded by thtise frotti Apple who c<Kle 
for the black box. In this information-driven world, woLildn'i 
cross-pollination be die norm, rather than the exception? 

DBM; OSS is starting to l>ecome so powerful iKX'ause of 
economics, not ideals. The ideals are awesome, but long term 
it's just economics. Qipyright law goes tlirough the congres^s, 
they are the ones who would be legislating such a ihing, and 
OSS doesn't exactly have a major lobbying ann. 

TSH: Well you and t are forming a very we;vk arm, but maylx* 
it’ll get stronger. 

DBM: 1 know, IVe just had to learn so much alx>ul trade setTeLs 
and IP that iLs just a lost cause in tliis way, because to me the 
real problem Is that OSS is acntially very wcll-protecied, it’s just 
that so few of those can make use of diase mechanisms. 

TSH: T honestly lielieve tliat ripping off OSS is more common 
than you’d like Uj think. 

DBM: Oh, I think its ccrinmon and hapi>cns, just more on the 
fringes. As awareness of an app goes up. and more eyes are on 
it, susjjicions are there and it's not hard to poke around—and 
the consequences can be devastating to a company. 

And there are great mechanisms for protecting OSS, it's all built 
into die copyriglti law, but Imtause iPs a civil thing the resources 
thit are often required to exercise them are just huge. Here's an 
example, the vast majority of OSS develoj>ers never go out and 
register the cxipyright For their ccxle. Ibis costs all of $30. 

TSH: Well, they should! 

DBM: So let’s say they find out a company is basiaally taking 
tlicir cxxle and reselling it, and want to go after them. A gexxJ IP 
lawyer casts $150 to $400 per hour or more, and most 
individuals simply caiVt afford diat kind of cash. However, if 
you've registered your copyright before someone is distributing 
stuff witli your code in it, it triggers all kinds of things like 
"willful infringement” and damages are starting at $100-150k and 


up. Now it starts making sense for an IP lawyer to take your 
case on contingency for getting his c'ash fnim the damages, . . 
but no OSS app developers do this, Ixxausc this is fun fur ihcni, 
nt>l a businejis. 

TSH: So it costs an OSS devclo|XT just $30 to c'opyright their code, 
but how much does it cost Apple to patent st)mediing? A whole 
lot more! So I understand exactly what you mean. But die OSS 
pmgramnier has another recourse, one much more influential than 
an IF attorney. . ,tliey conuia Dmakcnlyaiman and cTy teats of 
grief intt) the White Russian on your home jiage. . . . 



Figure 2. The Drunkenblog White Russian 

DBM: l.ol There is that option, but it’s not one I'm encouraging. 
Lol sorry, I’m cracking up here. 

TSH: But let's take this example. Not only Is there the legal itie.s 
of ’’willfull infringement. . ." 1 would, as the develo}>cr, take my 
case directly to the customers of the folks hawking the produa 
with my code in it . . .1 think they might lx* a little concerned, 
at least as far as their image goes. 

DBM: Yeah, !:>ul while I’m not a lawyer, I Ixlieve there can l>e 
legal prubleias in doing that Uk). And railly, the USA and such 
isn't where the scary stuff is going on. You want U> lx scared, 
drop into China or Pakistan or Russia. Ibis isn't well knowm to 
Mac users, Ixcausc no one there uses Macs, but it’s just a 
niglirmare there in terms of IP. 

Intellectual Property laws have gotten a bit whacky here in the 
USA and sucli, but when yfui drop into one of these countries 
w'ifh almost no IP laws to speak of, all bets are off. 

TSH: Microsoft especially has spent a fortune on nying to clean 
u]> Windows Piracy in China, and is .succeeding, I hear. 

DBM: Barely, and China is just one of iliem. Kyrgyzstan is a 
place I’ve learned a bit about, and you basically pop down to 
liicir markeLs and anything you want costs $5 on a disc. 

TSH: 'fhe whole notion of IP Ls pretty much a Western ideal 
anyway* 

Pve done (|uite a bit of traveling, and trying to find “genuine” 
software, music, or DVI>s in certain t:ouniries am be quite difficult. 
Getting the rest of die world to subscrilx to our views of IP is 
going to lake generations, if we're successful at all. 

DBM: There’s simply no recourse in these countries, and while 
IP laws are whacky here, they're what allow tipen .stjurce in the 
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first place* You drop in on some of these Windows shareware 
sites, and tlierc are so many red flags around some of these liiilc 
utilities. But again, Mac users don’t really see this Ix^cause hell, 
Macs are so fricking rare outside of a major urban area, let alone 
California. Half of tlicir sales are to the USA, so half of their sales 
are spread out across the rest of the globe, whic:h means they're 
spread pretty thin. 

Oh, other a)unLries will get there as they become more 
prosperous, they simply have to. It's economics, Ct)qx)raLit)n.s 
are starting to funnel a lot of tiieir IP into countries like China, 
and they want that pmtected. And as they generate more of their 
own IP, tlicy'll want it protected. They just aren't there yet, but 
they will be, and It’ll happen faster tfian it happened here. 

I'SH: Here’s a question- would open-source even exist if there 
were no IP laws? 

DBM: Yes, but only in the form of ‘'public domain software”, 
TSH: Well I think you and I agree that poaching OSS software 
should be met wiili consequences. 

Whatever they might be> 

DBM: OSS is basically someone saying ‘'I’m going to put this on 
the shelf for you to use, instead of keeping it to myself, but only 
if you follow the restrictions tn this license/ If you remove the 
ability to put those restrictions in, you’re just left witli "Fm 
putting this up here, do whatever the hell you want/ 

And we’ve always had tilings like that in some form, hut it 
would be much much less than the sheer mounlains of code that 
are being fu one led into OSS. 

TSH: Essentially the only restrictions are (generally) I ) distribute 
the source witli tlie product 2) all rights you have are everyone 
else’s rights, 

DBM: Right, the GPL is designed to keep wiiat's free free, 

1 do tliink OSS should be protected, but it’s basiailly alK>ut 
copyright law and our system. And there's no way in hell 1 tliink 
I'm smart enough io fix tjur system, or even offer suggestions., .1 
just know it's very hard for an individual to protect his iniellec^tual 
property, and that it's primarily the domain of corporations. 

TSH: Yes, free in the sense of uncaged. . * 

Not free as in the sense of cost 

DBM: Yeah, that's free as in beer versus free as in speecli. 
'fhere's no problem with selling OSS code a.s long as you don't 
take away rights or impose additional restrictions, Ifs a 
remarkable document, and was put together by very smart 
people, although reading it can make parts tif your brain ache. 
'I’SH; T know, my February column was laigely about the GPL, 
DBM: The spirit of the GPL does match the legale.se, but the 
spirit is about keeping free software free. However, a lot of 
people have never really read die GPL, but have the spirit of the 
GPL in their heads as sometiiing a little bit different. 

DBM: Tills is where the problem with Apple and KHTML comes 
in — they're following the legalese just fine really, but many 
don't think they’re following the spirit. 

TSH: Oh Apple and KHTML. Yeah, thaCs a good ptiint. Do you 
watch 'Ihe Bachelor? 

DBM: LOl, no, I can't .say I watch Tlie Bacheioc I’here's a ton 
of good TV out there, but I generally go by what's 


recommended to me, and llie Bachelor has yet to l>e 
rccoramended. Should 1 l>e watching? 

TSH: Well, my girlfriend and 1 waidied iJic last season of 1'he 
Bachelor, and it seems tliat tlie guy picked younger, less mature 
women liecause they're less of a threat and will lx.' more 
compliant. I see the relationship lietween Apple and KIITML as 
somewhat .similar I tliink Apple feels tliat the KH'IML folks 
should be saying “thank you thank you Apple for .selecting us, 
without you we'd be nothing ...” 

Many people c|uesLioncd Apple's choice of KI iTML over Gecko, 
1 was certainly one of them. But if you Icxjk at tlic Mozilla 
Foundation (http://www.mo7:iIla.org), liiat's .something, not [ust 
a little open-source project. I dunk Apple felt it could have its 
way with KHTML. but now there’s trouble in paradi.se. . . 

In many respects, de.spiie how far Safari lias come, I can’t lielp 
but feel that Apple's wjLsting ils lime Ixxause i\ seems tliat 
Kirefox is rising, while Safari is simply bundletf 
DBM: Really? Well, there are certainly wham-ham-thank-you- 
ma’am aspects to Apple, but most tif that i.s related to your 
pcKket bcK)k. In live case of K'THML, and why they chose it, you 
really have to go back to what their options were at the time. 
TSH; Tliey had another, more viable option. But they really 
needed a browser. Badly. And t|uiek. 

DBM: Here's the tiling: Apple is really short on people* They 
give the impression of this large company, 1)111 they are really 
starved for resources—their Mac’ division could well Idc in the 
red for all w^e know. 

TSH: 1 understand that partnering with an OSS group is a form 
of thrift, but it wouldVe taken le.ss lo slap Caniino into shape. 1 
think Apple took the paili of least resistance. 

DBM: The Mozilla engines are massive. ’Hiey're mulii-faceted, 
and weren't just a browser engine, they were a plaifonn engine. 
The entire interface is rendered in ihem, with technologies like 
XHl. Tlie axle base was just tliis huge, massive, spidered mess 
of code, and everyone on those projects knows it. It's similar to 
the NeoOffice/J simarion—gelling your head into it is hard. 
Wrapping your head around it witli limited resources would be 
a nightmaa", and my hat is off to Mike Rinkerton of Cliimera and 
Camino fame in more ways than you know* 

There aren’t ihat many (leople working on Safari. If 1 recall, 
OmniGroup tried to take the spideniionkey code for the 
Javascript engine in their Omni Web browser, and it was just a 
nighimare. KH'IML has major deficiencies in terms of 
compatibiliLy and tech, but from a time to market and resources 
issue, 1 wouldn’t lx? surprised if KtH’ML was really their only 
viable option. 

I think Pinkerttm would say the exact stuiie thing, that it's 
completely understandable why Apple went with KTHML over 
Gecko and friends, especkilly if they knew they were going to 
lie emtedding it into the OS and doing things like Dashboard. 
TSHi For some reason, 1 even knew back then that something 
Mozilla-based would eventually become the dominant browser 
on OS X* As far as timing w^ent, yes, 1 agree that KHTML miglit 
have been the lx:st option at the time, and OS X users were 
truly despenite to see something other than IE. 
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I Lljjnk the KHTMl. choice was an expedient choice made at the 
right time. In teniis of long-term viai>iliiy, 1 don’t think it's going 
to work out. 

DBM: Has Gecko liecxime the dominant engine on OS Xt 
TSH: As far as Vm concerned, ii ha,s. 

DBM: t wrote alxiut thb a bit in '‘Gecko's Unsiglitly Ass" awliiJe 
back. KHTOL may have been their real viable choice, but yes 
rd agree that Firefox is a better l:>rowser than Salari—although 
now necessarily on OS X. 

I'SH: Not for liome users, but certainly for the corporate world. 
Firelbx has been a (jodsend for fl' managers because there's a 
PC veisioii. 

DBM: I'his is actually a really interesting tiling on the Mac. Per 
capita, we have just tons of OSS around, but something like 
Firefox is just a bit deficient on tlie Mac* Ixtcause they don't have 
the Mac people working on it. Thunderbird kicks ass on die PC 
and Linux, but is just kinda weird on the Mac. 

Windows has a ton of OSS code around, way more than the 
Mac. 1 lowever, per capita, wliile it's growing, I don’t think iLs as 
large as it is on OS X and Linux. lf‘ Apple hadn't shipped u fa^e 
tcKilchain, Pd wonder if it would liave the OSS community in the 
way it does now. 

I’SH: IT wants Firefox becau.se it's not as insecure as IE, and 
because java sluff will work reasonalily well cross-platform. 
Safari barely works with jsp or applets though it's getting better. 
DBM: The key for Apple then is having to ‘keep u[}' with die 
standards, and devoting resources to it. Firefox has nailed out a 
lot of ilie.se compatibility issues, so if they were using Gecko 
they could “ride their work", but again 1 think many think of 
Apple as having more resources than they do. Safari 
unfortunately doe.sn'i work with a lot of things. It's important 
not to dismiss it, liecause Hyatt and others liave done some 
massive and impressive work there. However yes, the onus now 
is ail on tliein to improve .Safari and bring it up to par. 

TSII: rd like your take on tlic VideoLan Project, whr>se 
developers 1 affeaionately call the “Coneheads." 

DBM: Tlie VideoHin project is an aweisome one, and ties into 
some of wluit I was talking alxiut earlier tn a major way. Iliey're 
really screweil on OS X, 

TSH: What do you mean, “saewed?'' 

DBM: They simply can't get the people with the expertise they 
need to work on the project. Renienilx.T, ifs a cross-platform 
app, but there are almost always platform-specific things liiat 
need to Lake place in order to have the app kick aas. My 
understanding is that right now, they're having major, 
fundamental problems dealing with CoreAudio and otficr 
technologies. Wiiich means they need people with real 
CoreAudio exjrerience to help, and those are about as rare as 
little boys at Nevertand right now. 

TSH: Oh, you mean they’re screwed as far as llger goes. 

Not just Tiger, alih<mgh that's a big stumbling block. 'Itiere are 
issues with the cuneiit app on 10.3 tfiey know alxiut. Things 
that aren't in that they want to have in it, things that are in it that 
are flakier than they should be. However, VB developers are a 
dime a do^en on windows. I>cvek>pers aren'i a dime a dozen 


on the Mac, let alone people who really know what they're 
doing, let alone people who know what lliey're doing and 
knf>w Apple's technologies, let alone people who are all of the 
above and have the lime to contribute. 

TSH: Well, IVe l>eefi pretty impressed witfi VideoLAN on 10.3. 
DBM: 1 didn’t mean to imply I wasn't, just talking al>out the 
situation they're in. It's an extremely impressive effort. 

TSH: 1 wouldn't be surprised if someone didn’t step up to the 
plate to help them out. VideoLAN client saved OS X for many 
people, including myself. 

DBM: It saved it for you? 

1'Sll: In many ways, it's VLC that makes OS X tenable a.s a 
consumer OS. 

DBM: Tliere's always MPlayer. . . 

I'SH: Oh it's OK, but VLC’s a thing of Ixrauiy 
DBM: ’grins* Just saying, you might I^e surprised at how few 
f>cople are actually working on the 05 X port of VLC, which is 
why it's so impressive. 

And yes, Qiiick'i'ime isn't exactly the draw it once was to 
coasumCTS. And is especially onerous in 10.4, but perhaps that's 
just me. 

TSH: I think 1 heard from all two of them when I WTOte my first 
article “How the ConeHeads Could Save Apple" 
{hUp://www,themachelpdeskxom) in 2002. And hey, you get 100%of 
your daily "Royalty-bearing" technologies when you use 
QuitrkTime Player Pro. . . 

DBM: I lurk on some of wfial ihty’re doing so I can have a 
finger on their pulse, and while 1 can't say the exact number, Fm 
pretty sure I ain count the developers on one hand while 
holding a mug. And yes, you do get your daily allowance. And 
they make sure to remind you of tfiat, everywhere, while asking 
for your nish so you can play your movie full screen. Ifs really 
egregitjus and unctx)! behavior, and this is one of the things that 
can just set me off. They're tlieoretically in the middle of a 
fricking media player war with WMV and Real, yet tfiey’re 
making their player just suck. We saw this with Netscape and 
the browser wars ttx>. Micnjsoft certainly did uncool things, but 
rll go to my grave saying one of tlie reasons why Iniemei 
Expkjrer won, if not the main one, was that Netscape just started 
to suck. 

TSII: Let me see, I use VLC for: 1) Streaming in.strucLional videos 
for customers 2) playing back content archived form my 
RcpIayTV 3) watching VCDs 4) Watching .asf files 5) ripping 
incompatible video fonnals to mw pixels to import into 
QuickTime. VLC’s the Dutch Boy in the dike of OS X, as far as 
I’m concerned. Plugs lots of little holes, 

DBM: I guess I'm a little bit of a newbie when it comes to VLC, 
1 pretty much just use it for watching Doctor Who. 

TSH: And 1 know from reading your blog that that's really 
imix>rtant to you. . . 

DBM: If VLC didn't exist, QuickTime does accept plugias so 
those ctKlecs could i>e dropped in like 3iVX and DiVX are 
doing, but VI,C ju,st dex,^ it so much nicer. 

Good entertamment is a tiling of Ix^auty, and should be 
acclaimed. Good entertainment with an element of random 
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absurdity that only Uie British seem to be able to really do just 
makes me smile. U>h QuickTime is, at least from wliai IVe told, 
something you do not want lo see oixm-st:)urced. The code is 
just monsinms. Ok. Vm starting to feel bad. It should be 
mentioned that 1 have great respect for Apple and much of their 
work, but jiLst that they’ve been pushing the edge and letting lots 
of things pile up that are starting to come to a head, 

Maylie we could talk about something positive. Like iPtxis or 
something. 

TSH: Well, Tim Monroe, wlio's a columnist here at MacU’ecli, 
shows bits and pieces of Quicklime’s capabilities in each 
month's column, Qtiickrime is certainly a whole lot triore than 
a simple video player -“plug— for example, if you wanted to 
develop a video interface to a hardware device, Quick'ft me has 
facilities for that. 

DBM: QuickTime is a plalfomt, that's Ixen built up over years 
and years, and as such is kind of like Mozilla—unless you ve 
Ixxm working with it for years and years, your brain wtjuld just 
go into a coma if ytm had in deal with the cxxJe. 

TSH: You menlioned that the VideoLAN Tolks needed 
programming help. They might nec*d legal help as well. It seems 
that [he European Union is trying to shut them down. I h>w' dt> 
you feel atx)Ut such a valualrle (especially to OS X) OSS 
Ledmology l>eing subject to targeted legislation from a 
governmental bexly to uphold patents, even when it's obvious 
that no infringement has taken place? Is a format the Ix^all-caxL 
all, or can a format he successfuliy arrived al from two separate 
code (rases? 

DBM: As to the legal issues artrund VLC, I’m as.simiing you’re 
miking alxnii the propt)sed and pending changes to the 
Euroixan 11^ laws to make tliem more in line with America's? 
TSH: 'Hial s precisely what I am talking about. 

DBM: It’s a rough .situation, and one I haven't really made uj) my 
mind on. See, tliere are dtl’ferent kinds of infringement at work 
here. Tliere’s copyright, wliicfi is an expression of soTneihing, 
and then there's a patent, which is an kim of .sometliing. 

TSH: The VideoLAN folks seem to lx quite convinced this might 
lx the end of the road for their project. 

DBM: It could well lx. The problem isn’t the cotle they've 
written, that's theirs. It's the ideas covered by the patents in 
many of the things they've written: namely the codecs. 

1 should say that people saw this coming, and it s why we Itave 
formats like Ogg, which were designed from tlx ground up to 
nut infringe on any patents wlialsoever, 

TSII: Well, w^hen something is disiributed in a certain formau 
does the patent lollow the product indefinitely? So what you're 
saying Is Uial the actual video product can lx inevocably c losed, 
so tliat it am never lx legally viewed without a litxmsed ccxlec? 
DBM: Ogg is the container Ibrmat, with various codecs, audio 
and visual, and sotnetliing like Varbts would be the audio codec. 
It’s completely patentTree, but Ogg Vorbi.s hasn't tiiken the 
world by storm for audio files. 

It's not alxjul the fomiai necessarily, its the ideas that go into 
cTcating the fonnat. 

Say for example, something like H.264, Tlib ccxlec was basically 


designed by a bunch of companies that got together and pooled 
tlteir IF to create this killer codec. The key word is IP, and diey 
own the parents to all of it, and .setup a company designed to 
collect llie royalties. Same for MP3. Lots of Linux distributions 
require you to download an MP3 player, or perhaps it's tlie 
encoder, bec’ause they can’t do it legally. Apple went and 
liOLighi licenses to all tliese things, which others aren’t. 

'TSH: Well, tliat's a gray area to me. For eximple, Micn^soH got 
away with FPNW (File and Print Servjc:es for Netware) and a 
Gateway Service lor Nelware, which hel[xd Winduw.s N L displace 
NeLwaie as the dominant Network OS in the ct^rptvrate world. 
That was OK, right? Samba is OK? 

TSH: SAMBA and such are different, that's clean-room 
reverse engineering. 

And how is VideoLAN not reverse-engineering? 

DBM: Because they haven’t dt>ne any reverse-engineering. With 
somcihing like SAMBA, lliey seiuf) a Windows machine, sent it 
pickeLs on the port, and tried to guess what it expecled. After 
a ton of trial and error, they were able to work out — wath .some 
bugs — wliat NT was ex^xiiing and such. To my knowledge, 
patents weren't an Issue. 

TSH: And so Ixing able to play back a Ibrmai wathuut die 
source code to the cotlec^ is done how? 

DBM: Wlial goc-s inlti creating that foniKit is a published spec, 
w'hal apple's calls an ^Open Standard", Inii it's really a 
mbnomer. 'lliis is usually in relation to Microsoft's ctxlecs. It's 
not an open spec, it's one they’ve pul up to use and use, 
jmwuled ymi pay ibem ivbai mking^ 

And really wiiai it comes down to are tilings like meiluxl 
patents, and ihroiigh them software patents. 

TSH: What you're imt>]ying is that the VLC folks are kntmangly 
NOT paying whal tliey're supjxjsed to? 

DBM: Well, if they were in Amerk^i iheyki probably lx shut down 
already, and that's the (mihletn. Yes. if they aa^ going to lx using 
M)meone else's IP, under our system, they* should lx paying. 
TSIl: So what yoii're .saying is ihai if the El) changes IP hw to 
lx more like ours, the VideolAN project will have to move to 
China or pay. 

DBM: LoL Pretty much. I dfHilit that the cckIc wall die, this stuff 
is like playing wh:u'k-a tiioie waili a hydra. It’ll go splat, .spread, 
and reemcige all over the damn Cilace. 

Riglit now. die Ell LS lacking s^ime things we have here in the 
DSA around software patents, and that's really where the 
problem is. 

TSH: Well, you've kind of shot down one of my favorite 
projects. Damn you Batman! 

DBM: Once Llmse IP laws go intcj place, ihcre’ll lx a bullseye 
on VideolAN in a big w'uy. 

No, like 1 said. You can rebuild it, and make it stronger. It may 
even make weird noises when it runs, it'll ju.sl be doing it in 
Norway t>r China or something. 

Now see, lots of people think stiftware patenLs are just wrong, 
and they may well have a giKxJ f:Knni* 

TSH: Yes, I would lx one of those, especially in those cases 
when proprietary^ software won't make nice nit^e with otliers. 
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but dial's a can of worms we won't open right now. 

DRM: We have some really, really stupid shit going on. A gcKXl 
example is Amazon's ‘"One-click” paieni, which well, gave them 
a patent on Ixring able to dick a button and buy wluU you want- 
Apple ended uj) licensing it for $1 million dollars. Or someone 
ends up with a patent on a ty^x: of Window, or having 
something in a specific place. It doesn't matter lu>w it was 
ctxled, or the iinplemenuiikm, it’s just the idea itself, and )KH>ple 
much, mtich smarter than myself think we should really l^e 
l(K)king at how fliese laws tmnslate to our software, 

TSII; rd really like tt> know where Dnmkenblog is going to take 
us OSS fans in the next year or two. 

DBM: Yeah, well IVe set the l>ar kind of high now havent 1? 
Dcconsirtieiing MXS tcx)k well over 150 hours, 

'I'SIl: Yes, you have my friend, 

DBM; my plan is back to business as usual. 



Figure 3. Business as Usual 


In Next Month’s “Source Hound” 

Well, after my long talk with Drunkeniratman. I think I need 
to retreat a little Uj .something lighter, so I’m going to check out 
an Open-Source l^roject that everyone, including Apple, 
abscjluiely loves: SquirrelMaif Tliafs right, the ubkjukous, fun 
and nutty piece of webmail magic. 
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Sjxitlight is quite wifling to searcli the user's home directory 
tree, ft also looks into some other axeas, including /Applicaiions, 
/Developer, /Li):>rary, and /System. Ft stops short, liowever, at 
looking into the Darwin™ diretaorics (e,g., /bin, /private, /shin, 
and /usr). 

As a result, many interesting files (e.g., eontrt)! and include 
files, niiin pages) are not indexed. This seems like an 
unfortunate limitation. Most users aren't interested in these files, 
but some of us (e.g., administrators, power users, and 
ptx>gnimmers) find them to be very useful, indeed. Wouldn't it 
be nice to be able to use S[x>tlight to index these files? 

In fact, it is fxxssible to override Spotlight's built-in 
restrictions. Each volume's root directory coma ins a sul> 
directory (named .Spotlight-VlOO in Mac OS X version 10.4). 
‘l1iis comalrts a few “datalrase” files and a property lisi file 
(_rules.plisl). liy editing tliis property list, you c'an instruct 
Sf^otlight to include or exclude directories. 

Just l(x:aiing a file isn’t enough, however; we also want to 
lx? able to view it. And, if the computer can find cxmncctions 
tetween die files, some navigjititin aids (e.g., hyperlinks, linkage 
diagrams) would be lovely to liave. Although the interface could 
be implemented in Cocoa, HTML is an arguably simpler (and far 
more portable) approach. 


As an experiment in extending Spotliglu’s reach, I decided 
to write Morinfo, a siiiic of scripts that allows man pages and 
include file.s to lx? located by Sp<:)tlight and presented by a web 
browser. The results are useful, even in their current state, and 
offer interesting pos.sibililies for future enhancements. 

Background and Competition 

'I'urning man pages into IfTML is not a new idea. There are 
existing fadlilies (e.g., Internet servtrrs and downloadable 
applications) that perform this function. However, their 
approaches (and consc^quently, results) vary from mine. 

The FreeBSD Project (http://www.freebsd.ofg) provides 
access to the ‘‘FreeBSD Hypertext Man Pages™ 
(http://www.FreeBSD.org/cgi/man.cgi). Despite their name, these 
pages cover a variety of operating .systems (int:luding Darwin). 
Of course, tlie site cannot display arbitrary man pages that a 
user might have installed kxally. 

'Ihe pages are created by a free (i.e., Itbrt?) Perl CCd .script, 
available via die FAQ. Tlie script runs the man(l) command on 
an afipropriate input File, reformatting the results into HTMl.. 
Search is available within tlie CGI; Internet search engines (e.g., 
Google) also index the pages (e.g,, FreeBSD chmod). 
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Bwaiia (http://www.bruji.com/bwana) is a free Ci.e., gratis) 
appliaition which bills itself as a “imn page viewer for Safari, 
Firefox, Camino & IK”, 'lb use Bwaea, the user enters a LTKL into 
one of titese brtjwsers, using ihe scheme man (e.g-, maniGhmod). 
Bwana puts tlie gencraieil HTML in a temporary file (e.g.^ 
file:///...) and tells the browser to display it. 

Because Bwana generates its web pages as files, it 
cannot support a fonns-based “search” facility. And, because 
the files are temporary, Spotlight will not index ihcin. Bwana 
does, however, provide an “index page” {accessible via 
man:) which lists tlie known man pages {with .short 
descriptioas, if available). 

Both of the.se facilitie-s provide links to other man pages, but 
only within a limited context. Bwana only links to pages on the 
local machtnei the FreeBSD site only links to pages for the 
current OS variant and version. Neither facility links to anything 
other than man pages (e.g*, include files). 

Objective and Approach 

My initial objeaive was to make tlic files convenient to use 
and searchable by Spotlight, The usage requiremenL was met by 
handing the files {suitably edited) to the user's default web 
browser. The “search” rcc|uiremem was met by (a) using an 
extension that Spotlight indexes and {b) pulling ihe files into a 
directory that is traversed by 5podiglii, 

HTML makes it possible to generate hyperlinks, using 
implicit linkage infortiiation tliat is present in the file.s. The 
entrie,s in a man page’s “SEE ALSO" section, for example, can 
Ixrcome links to other man pages. References to include files 
(e.g., in sections 2 and 3) can afso be turned into links. 

Even with the addition of client-side technologies (e.g., 
Java, Javascript, SVG), web pages do not compete with Aqua for 
attractiveness, inicraciive pcrfornruince and richness, etc. On the 
other hand, they have significant advaniagcs for this 
(exploratory) proiecl. 

HTML give,s me a familiar and powerful user interface, with 
both local and Internet-wide navigation. Better yet, it retghres 
very little effort on my part. Finally, HTML is a much more 
]X)rtable technology titan, say^ CfX'oa. 

Resource Usage 

(direful Reader may liave noted ihai 1 haven’t dist:u,ssed the 
resource us;ige of this approacli, whedier in online storage or 
pnx^essing time. This Ls not because there isn't any; indeed, it 
uses hundreds of megabytes of storage and (initially) several 
hours of processing time. However, I don’t think ilits will matter 
for mt>st of our readers. 

Tile storage iiiipaci mim>rs, almost exactly, the storage used 
by the original files, I add a tiny bit of HTML, of course, but this 
mostly geLs Icxsf in the noise. tTie edited man pages and include 
files (including BSD, Oxoa, XI1, etc.) tKXupy about 350 MB of 
storage. Even if the edited versioas used a gigabyte, most users 
wouldn't notice the impact. 


*lTie processing time, as noted alxive, is c|uite .substantial. 
On a B<^W G3, the initialization script runs for an hour or so. 
Spodight’s importers also take a while to index the material. On 
the other hand, diese aedvities have little impact on the 
interaaive performance of the machine, so wliafs the probleiii? 

Online storage and background processing time, in die 
amounts Morinfo uses, are e.sseniially free. If having a nicely 
indexed and cross-finked set of reference pages is u.seful, most 
u.sers will gladly provide the necessary resources. 

File-based HTML 

My first attempt created m'ML files in a folder that Spotlight 
is known to search. Mac OS X “knows" that files with an 
extension of html should be viewed by a web iKowser, so 
double-(:lic:king these files "just Worked”. Unfortunately, this 
approach has significant limitaiioas. 

When an HTML file is dou[>le-€licked in the Finder, the 
resulting browser window shows a URL of the form file:///.,,. Tliis 
indicates dial the browser i.s reading the file direedy (rather than 
through a web server). 

Because no web server is part of the process, HTML files 
cannot make use of CGI scripts, HTIF header magic (e.g., 
cookies, redirects), Server-Side Includes (SSIs), or other server- 
based technologies. They can. however, take advantage tif 
many client-.side features {e,g., CSS, images and client-side 
image maps, Javascrif>l). 

An HTML file can also link to any type* of web page, 
located anywhere on the Web, So, for example, it could link to 
a CGI-based page that pt)st-pr(x:e>sses the Fite itself, adding 
information or dynamic capabilities. I considered this approach, 
but (fortunately) found a cleaner solution. 

CGl-mediated HTML 

I now create “template files", using a CGI script to post¬ 
process them into web pages. This is more complex than my 
initial approach, but it allows me to use die full power of the 
web server. The following diagram summarizes our data and 
control flow, in the context Sptjilighi and the Finder: 
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Figure L Data and control flow 


Spotlight and its importers gather information from (he 
file system and from new (or changed) files, This information 
goes into the Spotlight Store, where it can be accessed by 
Spotlight clients (e.g., the Finder). Similarly, mjnil reads 
include files and manual pages, generating template files for 
u.se by morinfo. 
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The template files are “new files", stored in an are:i that 
Spotlight indexes, so any keywords found in them are entered 
into the Spotlight Store. This means dial the user can find 
relevant template files, using the Finder's Spotlight mode. 

If the user double'clicks on a template file, mjmk gels 
called into action. Using the 'TOSIX padf of the template file, 
it directs the user's browser to display a genentled UKt. This 
causes morinfo to start up, read the template file, and produce 
a web page. 

m_liiik 

mjink is a tiny .snippet of AppleScript, but it performs a vital 
service. When a template file is double-clicked (i.e., “opened”), 
m_llnk generates a UliL that (a) invokes the CGI scri[>l and (b) 
includes the path to the template file. 

Tlie initial version of the AppleScript code below was 
provided by Chris Nandor, of Mac::Glue and MacPerl fame. 
The on open block is run when the script is asked to open a 
file. The enclosed code retrieves the file's “POSIX path", 
appends it to a prefix string, and hands it to an open 
location command: 

— m„link 
on open 

set fllepatfi to POSIX path of thie„item 
set pre to "http://localhost/cgi-bin/" 
set pre to pre h "morinfo?file-" 
open location pre rilepath 
end open 

Launch Services 

When a file is double-clicked, biunch Services attempts to 
determine which application should lie “launched” \o work on 
it. Tmditionally, Mac OS files had Creator and Tyi>e codes 
(stored in their resource forks) which supplied this information. 
More recently, Apple has allowed file extensions to be linked to 
particular applications. 

Beciiuse my files are managed by command-line tools (e.g., 
perl, vi), creating and maintaining resource forks wtjukl [>e c|uiie 
a nuisance. So, I use the second metliod, a.sserting ]>riority over 
any file with a ciLslom extension (.ht4m - “IH'ML 'lemplate for 
Morinfo"). Any user am assert tlus priority, using the Finder’s 
File > Get Info dialog, hut the prexess Ls a bit involved: 

• Click on a rc^presentative file, selecting it. 

• Type Command-I (or ii.se the Finder's File > Get Info menu 
item), 

• In the (Tptm with: section of the dialog, navigate to Other..., 
then to the desired application. 

• Click on the Change All... hulton, telling the system to use 
the s;tme script for all files witli tliis extension. 

• Clo.se the dialog. 

I didn't want to burden our users with all this effort, just to 
get Morinfo installed. St), I put some assertions into m_link's 
lnfo.plist file; 


< ke y >CFBiitid 1 eTy peRx r e nn ions < /key) 

^array) 

<st cing>ht4m</st ring) 

</array) 

(key)LSIsAppieDefauitFo rType </key> 

<true/> 

My installation script copies a “Morinfo" directory into 
/Applications, using CPMacO ). During the course of this copy, 
the OS examines m_tink's Info.plist file and notes these assertions, 

Template Files 

My template files are (typically) stored in 
/Library/Documentation/MohnfO, Tt) supiX)rt the widest possible 
range of initial files,! apjx^nd the full path name of the initial file 
onto the Ixtse path. 1 also add an intervening level (e.g„ HR MP), 
to designate the “name space” (c.g,, Header i-ile, Manual Page) 
that is Ixjing displayed. 

We also adjust the file names in assorted w-ays (e.g., 
removing any g^ extensions, adding a consistent extension of 
our own). The resulting path names ItKik like 

/Library/Documentation/MoTinfo/HF/ 
usr/tndude/stdio,h.ht4m 
/Library/Documentation/Morinto/MP/ 
usr/s hare/man/man 1 /cp. t ,ht4m 

The editing of the file content depends on the format of the 
initial file. In die aise of include files, I simply create a 
navigational heiKler and endo,se the include file text in a PRE 
bkx'k in an HTML page. I alsi> insert st>me ‘'placeholder” strings 
for the CGI script lo expand, as appropriate. Finally, as discussed 
Ix'low, I generate off'-page links. 

In the c:ase of man pages, I also need to (expand and) 
fonnal the pages into an ASCII representation. Fonunaiely, die 
man(1) command does this quite readily. 1 dien turn any nroff(l) 
backspace sequences (e.g., (''Hfo^Hoo^Ho) into appropriate 
HTML ,scxiuences (e.g., <B>foo</B>). 

Link Generation 

The final step is to recognise refereiK’e.s lo oilier pages and 
convert them into links. Include files and man pages have fiiirly 
predictable rormat,s, so recognizing SFl: ALSU entries and 
^include reference.s isn't particularly challenging, (jinversion into 
links, on the other liand, can lie. 

Heaiuse of Darwan's eclectic nature, man pages have 
somewliaL irregular names (e.g., Is.1, cal1,gz, tic.lm, mdS.ISSI). 
When T adjust the names of the man pages, 1 normalize diese 
names, ‘iTiis simplifies the proc'css of generadng links lo man 
pages, bec'aiise T don’t liave to keep track of txldlxill extensions. 

Generating links for J^include references Is where diings get 
,sticky. References don't speciiy the exaci direciory wlK^re die 
include file is lorated. At most, ilicy provide hints (e.g., specifying 
a parent directory ora hint alxiut the fde's Framework). ALsf>, many 
include files enclose ^include references within conditional bkxks. 
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None of this presents a problem for the t’onipiler; Xecxle 
and/or make(1) files keep track of include directories and pre¬ 
processor definiiions, handing them to compilers as needed. In 
my case, liowever, I have no sucli lielp. 

mjnit deals with the problem in a somewliat '‘heurisLic’’ 
manner. First, ii .scans direaortes where iticlude files reside, 
recording the full path names of all files found. Armed with this 
information, ii can make “educated guesses'* about the path 
name ihai matches a given “hint”. 

If a conflici arises, an error tnessage is generated. I’liis 
allows the programmer to add an “override” rule to deal with tlk! 
ambiguity. No, it's not very elegant, but ambiguaus infurmution 
is a common prc)l>lem in automated metadata processing. 
Elegance is nice, but functitmality is the overriding concern. 

Incklentally, the use of offline processing allows me to 
do some cute things with the link information that I detect. 
For example, I amid add “!>ack links" (e.g., from an include 
filers page to any pages that reference it). 1 could also 
generate “context diagrams" to assist the user in 
understanding the (local) link struciure. These features are 
currently under development 

Contextual Issues 

By doul^le-clicking on a file, the user jumps into a 
different “context". In our case, the new context is a web page 
(e.g., in Safari). This can cause confusion for die unwary: if the 
user makes a follow-on search, using the browser’s 
“magnifying gla.ss" text area, she might be expecting a 
Spotlight search to exxur. 

Imagine her dismay when a Google (i.e., Internet-wide) 
searcli liappens, instead. To be fair, die browser's magnifying 
glass is accompajiied by die word “GcKjgle". On the other hand, 
the user might Ix^ busy, or clistmaed, or... 

Even disregarding the issue of confusion, how is the user 
supposed to search local files from within our web page? 'iFie 
“obvious" answer ts to provide a fonns-based interface to 
Spotlight, but this might cause even more confusion. Sigh. 

Privacy and Security 

The first mrarnation of Morinfo copied (edited foniis of) 
system files to a different Uxation on the lcK:al file system. This 
did not intrexiuce any obvious security holes, but it wasn’t very 
powerful, either Tlie current version is more powerful, but it 
introduces some possil^le privacy and security holes: 

• Well .server - Well servers can have exploitable bugs. 
Administrative errors and oversights can allow security holes. 

• CGi script - CGI scripts can have exploiiai>[e Imgs. 

• Publication - Publishing local files on die well may reveal 
private information. 

If the server does m>t need to lie vlsilile frt>m otlier 
machine.s, a firewall can provide some protection, Mac OS X lias 


a built-in software firewall which sliuuld lx turned on and 
configiifed to provide the desired balance Ixtween security and 
convenience. Unfortunaiely, ai tliis writing, it does not allow 
Personal Web Sharing Ci.c,, Apache) to lx lilcxked. Strong 
proratton c:in be provided, however, by the use of a 10-liaseT 
Toiiler" (e.g., using NAT). 

Some applications (e.g., CUPS) provide their own HTTP 
servers, using different ports dian the default HO. So, a 
firewall can block access to GDPS, wliile allowing access to 
the “normar web server offerings, IJnforiunately, there is 
nothing to prevent two programs from claiming the s^une 
port niinnber. 

CGI scripts receive umnisted information from queries, 
CfKjkies, etc. Scripts should check all incoming information, 
making .sure that only legitimate requests are honored. The 
“Taint dtecking" failure (e.g., in Perl) can ensitre that the script 
h;ts done this, but it cannot tell wlietlier die sc'ripfs lesiing axle 
was bulletproof. 

Although rc^iid-only access to “Darwin files" .seenis pretty 
iantxent, complexities can arise. For example, a developer 
might put proprietaiy' files into a “system" area, ilien lx 
un]>leasantly surprised when the files show up on Google. 

Current Status 

TTie currenr version of Morinfo is largely a “pr<x)f of 
concept" implementation of a semi-mechanized tool ft>r 
d<K‘umtmrafion collection and mechanization. The functions it 
employs or provides include: 

• Collection (e.g.. File System to Spotlight Store) - 
Sjxnliglu (and its importers) perform dynamic collection 
of metadata alKXit files and the file system. Morinfo 
analyzes and reformats two types of files: man pages and 
include files. 

• Search (Query to File Ust) - S|x)tligln (and ilh clienis) use 
the Spotlight Store’s metadata for analysis, search, etc. 

• Launch (File to Application) - Unmch Services provides 
assorted ways to launch an application, based m the 
attributes of a double-clicked file. Morinfo uses tiiis lo bind 
its generated files to an AppleScript (m_link), 

Morinfo uses m^l’ink.app's Inlo.plist file lo assert 
jurisdiction of all files which have an unusual extension: 
litTm. Some Mac programmers dislike this technique, but it 
has the advantage of not retfuiring the creation and 
maintenance of resource forks. 

• UI Startup - mjink adds a preface string to the “POSIX 
path" of the double-clicked file, creating a URL string. It 
uses this to “invoke" an arbitrary application (the user's 
default web browser), directed lo a partieular document 
(i.e,, the file). 

• Presentation - morinfo (the CGI script) uses the file as a 
lemplaie, adding eye candy, navigational aids, etc. 
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• Feedback - m<mnft)'s web pages include maiko links whose 
Subject lines refleci the current topic, etc. 

Connections 

To review a bit, MorinFo makes use of some interesting 
“connections". Mac OS X provides some of these by default; 
others require a bit of hacking: 

• File content is t:onnecied (via importers) lo the Spotliglit Store. 

• The Spotlight Store is connected (via tlie Spotlight APIs and 
clients) to user queries, 

• Pile icons (e.g,, in query results) are connected to 
“apprcjprialc ap[>lications", as specified in Get Info dialogs, 
Info.plist files, etc.. 

• An AppleScTipr application can launch another applicution, 
feeding arguinenls to it as needed. 

• A CGI script can connect system files to manual pages. 

Because of "network effects” 

Chttp://en.Wikipedia,org/wiki/Neiwofk_effea), each new connection 
takes advantage of existing connections (and makes them 
more powertiil). At the same time, new ctmnections may 
expose existing resources u> new sc^curity holes. 

Wish List 

Tlierc are any numlx:r of directions in which this work 
could l)e extended. Let's begin with the funciions listed al^jve: 

• Collection - Morinfo needs it) fmve an importer, in order to 
track cliange.s and additions to its monitored hie areas, 


Spotlight I racks files, bui not processes. If Mac OS X 
suj>poited DTrace (Sun's Open Source data collection 
system), it could colleG metadata at arliilrary system call 
Ixjiindaries. 

• Search - S|X>tlighfs query language is missing features such 
as reguLar expressions and “order" t'ompari,sons for strings. 
The Finder's "Spotlight mode" lacks convenient ways to 
specify coin|>ound matches or exclusions. As programmers 
and users make their wishes known, we can expect to see 
some enhancements. 

■ Launch - The current (extension-based) link has 
philosophical probleirLS for some. There may be a “cleaner" 
way to do this, 

• UT Startup - m_lmk is acceptably sprightly (even on a G30, 
easy to modify, and quite flexible. 

• Presentation - morinfo is almost a “blank slate" at this point. 
I foresee diagrams (for context and navigation), interaction 
sLij)fK)n, and much more. 

• Feedback - Morinfo needs a wiki-like sulxsysteni to t'ollea 
page-specific u.ser feedback. Sharing of locally-collected data 
(e.g., for trend analysis) Is also possible. 
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QUICKTIME TOOLKIT • by Tim M^roe 


Back To The Future, Part II 

Developing Applications With The 
QuickTime For Cocoa Kit 

I n the previous QuickTime Toolkit article (“Back to the Future” 
in MacTech, May 2005), we began looking at Apple’s new 
Cocoa framework for displaying and modifying QuickTime 
movies, called the QuickTime For Cocoa Kit or the QTKit. We saw 
how to open and display a movie in a window of a Cocoa 
document-based application; we also saw how to manipulate 
movies using command-line tools, which would be quite useful for 
batch processing via shell scripts or other scripting mechanisms. 


Introduction 


In this article, well continue out 
investigation of the Q'rKit frameu^ork, 
which is available in QuickTime 7 on liotli 
Panther and Tiger Well see haw- u> extend 
the sample application KitEe^ that we 
l^gan developing in the previous article to 
siipport I he complete set of standard 
document beliaviors (Save, Save As, Keverl, 
and so forth). Toward tlie end of this 
article, well .see how lo restrict the file 
types displayed in die fiie-opening dialog 
lx)x. Then in the next article, well wrap up 
our tour of the Q'llCit by looking at some 
ridvanc'ed uses of its classes and iiiethoLLs, 

Document Behaviors 

So far, our sample applicaluin KitEex is 
able to open any kind of file thai 
Quick'rime can handle — standard movies 
files, Flash files, MP3 files, MPEG-I files, 
AIFF files, text files, and so Forth — and 
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display the movie data in a Qxx)ii dixuineni windtiw. Figure 1 
shows a typical KitEcz dcxTiinent windcjw. As you can see, the 
movie and the movie controller Ixir completely fill the content 
region of the wintifiw, As you am also see from ilie liourglass 
shape of the diiimb in the movie ioiilroUer bar, the movie is 
ediluble using the items in the Fxlit menu or tlieir standard 
keyboard shortcuts. 



Figure 1. A window that contains a QTMovieView 
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Bcaiusf movies opened using KitEez are editable, well 
want 10 su[)port all the standard document behaviors: 
Undo/Redo, Save, Save As, Revert to the last saved version, and 
so forth. If you have developed Cocoa docunient'based 
applications before, then youH know that Cocoa provides a 
sophisticated dwument architecture that tracks changes to a 
document and responds appropriately to user actions. For 
ioslaiice, if the usct tries to close an edited but unsaved 
document window^ CcKoa will display a sheet that prompts the 
UsSer to s;ive or discard those changes. The Cocoa dotajmeni 
archireciure, however, has no knowledge of what it means to 
save a QuickTiine movie, so we'll need to override a few 
NSDocumenI melhcxis to add that and other standard dcxaiment 
behaviors to our sample applicaiion. 

Supporting Editing Operations 

IFs actually trivially easy to suppon the standard undo and 
redo mechanism for edits [nadc to a QuickTime movie that is 
displayed in a QTMovleView in a Cocoa document window, Ml 
we need to do is make the associated QTMovie object etlitable, 
and we saw ho’S^ to do this in liic previous article with this single 
line of code: 

[movifi sfitArtribute: fNSNuraber numberWitbBooliYESl 
forXey:QTH qv ieEditab 1 eAttrihute] j 


Once we’ve executed this line of code, the movie can be edited 
using QTMovie View methods like cut:, copy:, paste:, trim:, and the 
like. Indeed, tile default l>clravior of the Edit menu items is to 
issue these IB actions, so we need to write exiictly 1 line of code 
(shown above) to have a full-fledged movie editing application. 

QTOit provides ilie standard multiple-level undo and mdo 
processing. A user can cut, copy, and paste to his or her bean’s 
content and then undo all those editing operations. Also, QTKit 
auiomaiically provides the standard drag-and-drop editing 
operations. A user can drag a movte segment out of a movie 
window and into any other objecl that can at:cepL dragged 
movie data. Figure 2 shows Lite drag image being dragged out 
of a movie window, 



Figure 2. A dragged movie segment 


The performance of the dragging in Q'fKit-based 
appliaitions is vastly improved over that provided l>y the 
standard mt>vie contn)!ler In some benchmarks, the 
creation of the drag image alone was over 3000 times 
faster in QTKit applications than in applications using ilie 
movie conlroller's drag-and-drop cat)al>ilily. 

Saving an Edited Movie 

When the user selects the Save item in the File 
menu, the first responder’s saveDocument: method is 
executed. The NSDocument implementation of this 
method checks to see whether a file is already 
associated with the document; if not, it displays the 
file-saving sheet to elicit a filename and location from 
the user. 'Fhis will never actually happen in KitEez, 
since we only ever open movies from existing files. But 
it might happen that an edited movie cannot be saved 
into the file it was opened from. For instance. Kit Fez is 
able to open MP3 filesS as QuickTime movies 
(iransparenlly invoking its MP3 import component), 
w^hich are then fully editable. But QuickTime does not 
provicle an MP3 export component, so KitEez is unable 
tf> save the edited data back into the original MP3 file, 
In that case, we’d want to display the file-saving sheet 
so that the user can save the data as a QuickTime 
movie file (.mov). 

Tlie QTMovie class provides a method that we can 
use to determine whether a movie object can be saved 
into its ass(K'iated rile, can Update Mo vieFile. Listing 1 shows 
our override of the saveDocument: method. 

Listing 1: Saving a document 

(ISAction) saveDocument: (id}fiendec 
f 

If (L LuiovieVlew moviej canUpdaieMovieFil el) 

[super saveDocument:senderj ; 

else 

[super saveDocumentAs:senderJ: 


This is simple enough: if the movie can be saved into 
the file it was opened from, then we just cal] 
NSDocumenl s saveDocument: meihod; oiherwisc we call 
its saveDocument As: method. 

NSDocument's saveDocument: and 

save Document As: methods internally call 

writeWithBackypToFile:ofType:saveOperation: to actually 
write the document data into the associated file. We 
can override that method to save the edited movie data 
into the original mfivie file or into the newly-selected 
destination file. Listing 2 shows our override method. 

Listing 2: Writing out tlie movie data 

- (BGODuriteWltliBHckupToFlIe: (NBString •JfileNana 

of Type: (NSString ’) ducimen tTy peName 
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saveOperation: CNSSaveOperatioTi'i'ype)saveOperationType 

I 

BOOL success = NO; 

if (saveOperationType = NSSaveOperation) 

success = ffmovieVlew movie] tipdateMovieFile] j 
else if (saveOperationType = NSSaveAsGpcration) \ 
success = f fiiiovieVlcy movie]wrlteToFile;flleNaime 

wiihAttributesitiil] : 

If ^pSuccess] I 

OTMovie ‘newHovie “ [QTMovie uovieWithFiletfileName 
erroi::nilJ ; 

[movieView setMovie:newKovie] : 

[self initializeMovleWindow]; 

} 

I 

returti success: 

When the requested openUiQfi is NSSaveOperation, wc 
simply Ciill the updateMovieFiie methcxl to update the movie 
atom in the movie File. Wlien the requested operation is 
NSSaveAsOperation, we need to do a liiile more wc)rk. As ycni 
can see, we first call the QTMovie method 
writeToRleiwithAttributes: with a nil dictionaiy of attributes, liiis 
has the elTect of writing only the movie atom into the destination 
file. What we end up with in this case is a reference movie, that 
is, a movie whose media data is located in some other file. If 
instead we wanted a seibconiained movie tile, w'e ctmkl call 
writeToFileiwithAttributes: witli a dictionary that indicates that we 
want the movie to be Hattened into the destination file, like this: 


As you know, the standard behavior when performing a 
Save A.S operation is to replace the movie in the movie view 
witli the movie in the new destination file. So, t>nce weVe called 
wrtteToFile:withAttributes:, we then need to open the movie in the 
new file and set it as the movie displayed in the movie view. 
Then w^e need to perfonn any movie eonflgiiraiion that must 
happen when a movie is opened. As you can see, we call the 
method initializeMovieWindow, defined in Listing 3- *l1iis code is 
lifted whoiesiile from the windowControllerDidLoadNib: method 
we considered in tlie previous article on Q'LKit. 

listing 3: initializing a movie and its window 

- [void)initializeMovieWindow 

( 

QTMovie * movie = iTnovieView movie I: 

// muke the movie editJible 

[movie setAttribute:[NSNumber nuinberWithBool:YESl 
forKey ^OTMovieEditableAttribute]: 

// use the QTKiL's resize indicator, not NSWindow's 

[ [inovleView window] EetShowsReeizelndicator :N0] : 

[mavieView setShowsResizelndicator .YESl: 

// M a listener for size-changed notifications 

f [fiSNotificatiotiCenter defeultCenterl addDb^rver;self 
selector:®seleetor(boundsDldChange:) 
nametQTMovlGSizeDltlChanguNoLiricatioti object:aKJvl^] : 

I 


success “ I tmovieView aioviel writeToFlle:filename 

withAtt 1 1but as:[NSDletiona ry 
dlctionaryWithObject: [NSNiimber numberWi thBool :YKS] 
forKeyiQTMiivleFlattenn J 

rll leave ii as an easy exercise Ff>r the reader to ackl an accessory 
view to the save panel that allows tlie aser to determine wlieiher 
a movie is saved as a reference movie or as a self-contained 
movie, like the one displayed by the Quicklime Player 
application (Figure 3). 


0 B QuickTime Sample Movie 


Save As: Sjunple 

Where: .[BffiDesktop \V\ 


© Save as a setf^comalned movie 

Anv cxicrmtl mrclla will bt imluded In Thts msvle. 

Eiiimated file size: 80.4 KB 

O Save as a reference movie 

Any eKtemal movie i will be reQuireil to play this movie. 
Esiimoted fife size: 2.3 KB 


( Cancel ) Save -3 



Figure 3. An accessory view in a save panel 


It's perhaps worth mentioning that die 
writeWEth0ad<upTon!e:ofType:saveOperation: method is depreaifed 
in Mac OS X version 10.4 and later. Since however we want our 
application to run under all envimmnents supporting QTKit, 
including Mac' OS X version 103.9, well slick with this niethcxi. 

Reverting to the Last Saved 
Version of a Movie 


Theie remains just one dexument behavior for us to 
implement, namely reverting to the last saved version of a 
movie Die. When the user selects the Hevein item in the File 
menu, the Cocoa document handling code displays the sheet 
shown in Figure 4. 


O Q G Sampk.mov 



Do you want CO revert to the most recently 
saved revi Sturt of the doCMmenl 
“Sample.mov^ 

Your current ctiangei will be lost 


( Cancel ) f Revert | 

. . ff.wgu... y . . . 


^ QuickTime 

H*'i' '■«■'* 


Figure 4 The Revert sheet 
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[F the user presses the Revert button, the 
revertDocumentToSaved: meiht h 1 in the first responder is 
invoked. We won’t override tliat inetluKl, ,so that method in tljc 
NSDocument class will called. Rather, we’ll override the 
revertToSavedFromFile:ofType; method, as sliown in Listing 4. 

[jsting 4; Reverting to a saved movie file 

- [BOOL) tevertToSavedFromFiie: (NSString * JfileNanis 
ofType: (NSString Mtype 

[ 

QTMovle •newMovie = (QTMovle movieWithFI Je:fj IcNntne 
errcjr inll); 


outside the tnediods provided by QTXii into ilie underlying 
Qirlxin APIs. 11iis stands in stark contrast to the work we 
needed to do in our earlier Qx'oa movie-playing application 
Mfx>Veez, which relied on the now-deprecated Ctx'oa classes 
NSMovie and NSMovieView for its QuickTime supjxm. 1 invite 
you to lake a set:ond kK)k at the article describing those classes 
nhe CcK'oanuis*’ in MacTech, Deeenil>er 2002); by ct>mparing 
the Qirbondaced methods we had to write there witlj ilie purely 
Ccx’oa-based methods we’ve seen here, you wilt get a very gcxx! 
appreciation of how big an advancement ihe QTKit i.s over 
those earlier classes. 


[movieView jsetMovie t nevMovieJ: 
Iself initializetiovieWindowJ ; 


Openable File Types 


return YES; 


As in the Save As case shown in Listing 3^ we ojH'n the 
spetHfied file and assign it to the movie view; then w'e perFbrm 
the required iniliali/aitkm of tlie twwie and movie window. Alsti, 
we return the value YES to make sure that the change count of 
the document is cleared. 

So, we have successfully implemented a rea.sonahly 
complete set of doc'ument-reluted behaviors in our samj>ie 
application KitKez, using just a very few QTMovie iiiethods: 
canUpdateMovieFile, updateyovieFile, and 

writeToFife:withAttributes;. At no fx>int did we need to step 


in the previous aiticie intrcxiucing Ql'Kit, we saw that we 
can very easily configure the file-opening dialog lx)X to list all 
files openable by QuickTime by overriding ihe 
paneLshouldShowFilename: methcxl and calling the canInitWithFile: 
class methexL 'Huit method returns YES just in case a specified 
file can be used to initialize a QTMovie object. For certain 
purpases, however, we might want to restrict lite tyjK^s of files 
that the user can open to some more limited set. For instance, as 
yim probably know^ QuickTime can open text files with its text 
movie importer— wliich converts the text into a series of frames 
in a text track. (See “Word is Out” in Mm-Tech, November 2000 
lor more information on QuickTime’s lexf-handling atpabilities.) 
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Bur it’s doubtful that most applications that can open and display 
QuickTime movies would want to allow text files to be opened 
by lire user Diuo for HTML files. Ditto ft)r PDF files. 

QTKit provides an easy way to allow the user to open only 
the kinds of hies that would normally be considered as media 
files nnd hence openabic Ijy a QuickTime application. Instead 
of using the canInitWithFile: method, we can use the 
movieFileTypes: method, 'lliis too is a class method, so you donT 
need to have an existing QTMovie object in order to call il. 

The movieRteTypes: method returns an NSArray of file tyj>es 
and file extensions that can be opened by Quickl'ime. This 
method takes one parameter, which indicates ihe kinds of file 
types thal you want to he included in tlie array. Curreiidy these 
hags are defined for six'cifying file types: 


typed ef enujn \ 

QTIncludeSti1iTraageTypes ” 1 <C 0, 

QTIiiclutleTrtinelatableTypes ' 1 << U 

QTI^clu[^eAgg^esEiveTypGS =1 2, 

QIIncludeContmonTypes ^ 0, 

QTIncludeAllTypes “ Oxffff 

J QTMovie FI1eTyp eOp tion s: 


Passing the value QTIncludeCommonTypes indicates that y()U 
want the array to contain only those file types and extensions thal 
are tomnionly thougfu of as ofKaiahIc by QuickTime; lliis 
includes the extensions .mov and .mpv, as well as any fde tyjx;s 
thal can I'jc impoited in place liy Quick'l’inie. (Recall that to be 
able to import a file in is lo lx: able to impon die file 
without having lo cmate a new' file to hold the imjxMed data.) 

The QTIncludeStilllmageTypes flag indiailes that you want 
the array to include, in atklthon to the t:ommon file types, all 
types of files dial can be opened by QuickTime using one of its 
available graphics impt^rlers. The QTIncludeTranslatableTypes dag 
indicates that you want the anay to include alst) those file types 
that ain be opened by QuickTime using one of ii.s available 
movie importers, whelher or not the file data can be imported in 
place; this airay excludes however any file types that woukl 
require an aggressive importer. (An aggressive importer is one 
liiai can handle file ly[)es like text or HTML that would not 
nonnally be considered openable by Quick'l'inie,) Rnally, the 
QTInciudeAggressiveTypes dag indicates thal you w'ant the array 
10 include file ty|x:s thal require an aggie.ssive impoiter. 

Obviously, the QTIncludeAlJTypes dag sets all die hits in the 
options pammerer and requests that die reRirned array include 
file types and file extensions (or all files lliat QuickTime can 
o|x:n, using any available gra[ihics or movie inijiorter. Passing 
the array associated w'ith the QTIncludeAllTypes Hag to 
NSOpenPand's runModalForTypes: metliod is essentially identical 
to using tlie canInitWithFile: method inside our 
panel :shouldShowFilename: override method, 

it’s important to realize that, for instance, tlie array miumcd 
wiien .specifying the QTIncludeStilllmageTypes dag will include all 
file types and extensions for still image files m weii as all file types 
and exten-sions for the common movie types. Tliat is to say, dial 
array dcx:s not contain onfy the file types and extensions for still 
image types. If you wanted an army liice that, you would need to 


use Cximponent Manager funclions to iterate through all installed 
eonijxments and select oidy those of type 
GraphlcsImporterComponentlype. LLsting 5 shows how you might 
do dial. 

Listing 5: Finding still image types 

fileTypas “ [NSMutableArray array); 

ComponentDescription findCD = fO* 0, 0, 0, 01: 
ComporiGntDeEcription infoCD ■ iO* 0, 0, 0. 01; 

CoJnporient conip = NULL; 

OSErt err = aoErrj 

findCD. coinponGTitType = UrapblcslniportGrCoiiiptJtienLType; 

flndCD. conjponentSubType = 0; 

findCD.componentManufacturer ■= 0: 

findCO.componentFlags “0: 

findCD,componenlFlagEMask “ cinpIsMiGsing [ 

grapkicRExportGJrlsBaGeExporter; 

while (comp = FindNextComponent (comp, AfindCU)) I 

ert = GetComponentlnt’otcoinp, fitinfoCD, nil, nil, nil]; 
if (err = noErr) [ 

if (infaCD.componeiitFlags & 

movtGTmportSiibTypelfiFlleEjttension} 

[fileTypes addObjecl; f [ [NSStrltig 

stringWithCStclrigHchar * )6iinfoGn. com p orient Subtype 
ien^ch:sizeof(OSType)] 

stringByTrimmingCha rac t ersInSet:iNSCha racierSet 
vhiteepaceCharacterSatJJ lowercaaeString]J : 

else 

[FtleTypes aridObJuct: {MS,String 

stringWlt hFortHfil , [SS St t ing 

St ringWIthCSl r ing: (char *)nfoCTJ.componentSubType 
length:sizenflOSType) ])]: 

I 

I 


Conclusion 

In this article, we’ve added the standard document- 
handling beiiaviors to our KilEez sample a|:)plication. We've 
.seen how to use Qllvii methods to support saving an edited 
movie into its original file or into a new file, and weVe seen 
how to reven lo the last saved version of a tnuvie file. KitEez is 
now u reasonably complete multi-document movie opening and 
editing application. 

In the nexi aiticle, we'll take a lcK)k at some of the more 
advanced ojx^ralions w'e can use the Ql’Kit fnimework to 
perform. We’ll see liow to add images to an existing QuickTime 
movie, work wiih notifications and delegates, and execute 
QTKit melliods on a secondaiy thread. 

i\\\ 
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Relational 

database 


Object-oriented 

development 


A BErnn database can speed 

UPYBUBDEVEIOPMENTCYCIE 


If your rclatit>iial database isn't a good march 
for yt>ur object-oriented development, you need 
a new database* 

C^ache, the post-relational database from 
In ter Systems, combines high-perraniiance SQL 
tor faster queries and an advanced object database 
tor rapidly storing and accessing objects. With 
Gaelic 5 no mapping is required between object 
and relational views of data* lliat means huge 
savings in bodi development and prt>ccssing time. 

Applications built on Cache are massively 
sealable and lightning fast. They require little or 
no database administration. 

More than just a database system, Cache 
incorporates a powerful Web application develop¬ 


ment environment that dramatically reduces the 
time to build and modiiy applications* 

C^ache is so reliable, it’s the world’s leading 
database in healthcare — and it powers enterprise 
applications in financial services, government and 
many other sectors. With its high reliability, high 
performance and low maintenance, Cache delivers 
your vision of a better database. 

We arc IntcrSystcms, a specialist in data man¬ 
agement teclinology for over twenty-six years* 

We provide 24x7 support to four million users in 
88 countries* Cache is available for Windows, 
OpenVMS, MAC OS X, Linux, and major UNIX 
platforms “ and it is deployed on systems ranging 
from tw'o to over 50,0()C) simultaneous users* 


InterSystems A 

Kt CACHE 

Make Appimtions Faster 

Try a better database. For free. 

Download a tree, hilly hinetional, non-expiring copy of Cache or request it on CD at vwvw. InterSystems .com/match 3 


■I IlS lrliuiiu.liUlii.Tn 













DevDepot sells the tools, toys and technology to put more niuscle into your Mac. Visit our 

I online store today for special offers and great new products, www.devdepot.com 

^ ... „ 
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Television is about to get a whole lot more interesting.^ 


NOW ONLY 


EveTV 20 0 


The future of Televisian ™ 



Watch TV on your Mac 

EyeTV features a 124-channel cable-ready analog tuner and DVD quality 
MPEG-2 video encoder. 


Record TV on your Mac and Archive to Disk 

Collect and organize your favorite shows to watch whenever you want, 
then update video content to DVD.* (Toast 6 Titanium required). 

Don't miss a thing 

Use EyeTV's Electronic Program Guide to find exactly what you are 
looking for, and program EyeTV to record it. Program EyeTV from 
anywhere via the Internet. 

Features and Benefits 

• Record TV otn Your Mac • MPEG-2 Video Encoding : 

• Edit Out Unwanted Content ■ Digitize Analog Video 

• Archive Recorded TV To DVD* • The Speed And Power Of Firewire 



digital 


Convert your analog 
video tapes to 
digital in realtime, 
then burn them 
to DVD! * 



EyeTV now lets you 
export to IMovie*^, 
DVD® and DVD 


Studio Pro®, making 
it easier to create 
professional quality 
recordings. 
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More Great Products! 


SYNC BOX 


Buy Today and Save! 


t ransfer data from your USB devices with 
the touch of a button. 

* Never run out of memory space again! 


No computer required, 100% portable 
Sleek and compact design 
Easy to use, one button operation 
Complies with USB 1.1 specifications 
Supports both USB 1.1 and USB 2.0 
Uses 3 AAA alkaline batteries (not included) 



EASILY GET DATA FROM: 

• Storage Devices • MP3 Players 

- Digital Cameras * Card Readers 

• Flash Drives • AND MORE! 
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iTripmini 

The Trip mini was 
designed exclusively 
for the iPod mini. 


FM Transmitter 


Listen in your car! 

iTrip 


iMic 


USB Audio li^rfa^ ^ 


NO BATTERIES NEEDED! 

The Trip mini only needs a tiny bit 
of power that it gets directly from 
your iPod mini. 


m 




$3999 


The iMic is a must-have device for people 
who are serious about high quality audio. 

Connect virtually any sound device to 
your iBook, PowerBook, PowerMac or other 
Mac or PC with a USB port. 




-I 

/ 



Its form 
matches all 
the curves 
of the iPod 
mini, and 
sounds even 
sweeter! 






a Griffin Technology 




V 


iMic SUPPORTS: 

• Line Level 
Microphones 

• Mic Level 
Microphones 

• Multimedia 
Devices 

• Headsets 

• Communications 
Devices 


from Griffin Technology 












DevDepot is not responsible for typographical errors. Offers subject to change at any time. © 1984-2004 Developer Depot, Inc. Some 
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Pragramming 


Save Otir 


- lOI - 

Haw t:a 
write a 
Mac OS X 


part 1 


By David Hill 


Introduction 

Everybociy out there who ha^ used a computer 
for more than a few minutes knows w'hat screen 
savers are and there have been many screen savers 
written for the Macintosh and otiier computers. 
Some were single-purpose and provided only one 
animation hut did it very well. Many others rook a 
different approach and provided a generic engine 
that made use of plugin mt>tJuIes. With Mac OS 
Apple has included a Cocoa plugin based engine 
controlled via a System Preferences pane (Figure 1), 
The engine provides screen hjcking, window 
management, multiple screen support, and other 
fealurc.s, freeing up the plugin developer to worry 
about the part that differentiates their product, the 
animation. A minimal Mac OS X screen saver module 
needs to worry about nothing more than drawing 
the next frame of its animation when requested to 
by the screen s;iver engine. 

__ Otiimp * Unm ^ 

•* ' m a« e ia v tn 

jhowAtl lumipDtih Sbvipg_ 


‘ Dtiktop Scfttfl Siwr > 


^ Computer 
^ Ab'iifxi 

0 ntturct FdUH 
^ Ch'WW Forfl?r 
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Figure 1. Screen shot of the Panther Screen Saver 
Preferences pane 

Writing screen savers is ea.sier than ever with Mac 
OS X and in tliis article I'm going to start by showing 
you how to write a simple iiKHiule. We i! begin with 
the basics of st:reen saver construction in Xcodo and 
work our way Lip to handling events, providing a 
configuration sheets and changing display resolution. 
Along the way, well talk about dilTereni drawing 
APIs, debugging tips, rundoni numbers, and user 
preferences. I’ll also cover some tips and tricks as well 
as point out some trouble spots you'll need to watch 
out for 

For tlie purposes of this article, [*m going lo 
assume that you have Mac OS X and the developer 
tools installed if you want to follow along. You'll 
need some development experience and a basic 
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kaowleclgt* of C The interface for the screen saver plugins is 
in Objective-C Imi, since Object ive-C is a close cousin of C, 
most C/C++ and Java developers should be able to follow 
along without too much trouble. For those who would like 
to learn more about Object ive-C, Apple provides some 
excellent documentation on their well site at 
<http://developer.applexom/documentation/Cocoa/ObjeafveCLanguage 
-date.html>. ril also give all of my directions and screen shots 
with res[)eit to Mac OS X version iQ,3 (Fan!her) and Xcode 
so those of you running different versions of Mac OS X will 
need to mentally map from 1(J,3 to your OS version and 
development enviroiiiueni. 

Basics 

*r]ie ScreenSaver.framework provides two screen saver- 
specific classes that you 11 need (ScreenSaverView and 
ScreenSaverDefauKs) as well as a few utility functions for 
generating random numl-K^rs and centering rectangles. The most 
importani of the iwo classes Is ScreenSaverView, a subclass of 
NSVtew, The NSVIew class Is responsible for drawing to the 
screen and handling user input. The ScreenSaverView class 
derives from NSView and adds sui:>port for animation [>lus a few 
other .screen saver specinc meiluxls. 

One part of screen saver devek>pmenl that can be 
confusing to developers is the question of where to do their 
drawing. If you lofik at the ScreenSaverView headei; you1l 
notice tliai the ScreenSaverView class provides mo promising 
methmls: animateOneFrame and drawRect:. If youTe familiar 
with Qk^oh's view system, ynu1l recognis^e drawRect: as the 
standard metlujd in whtcfi views do their drawing and it turns 
out that this is Ixrst place for your screen saver to do its 
drawing as well. Hus is particularly taie for more advanced 
screen silvers that make use of subviews to draw with OpenGL 
or yuick'rime and well cover subviews in a later setlion. The 
reason to draw in drawRect: is that Cocoa will call drawRect: at 
varitjus points in tlie life of your screen saver and you must be 
ready to handle liiose requests. For dial reason, the 
recommendetl coding convention is to use animateOneFrame to 
update your animation state and then tell Cocoa that your view 
needs redrawing. This redraw^ rc(|Liesi will cause Cocoa to call 
drawRect: wJiere your screen saver will conipletely redraw^ the 
view to reflect its current state. In most screen savers, the 
drawRect: method erases die background, filling it with black 
or a background image, and then draws the objecLs tliat appear 
in the view. 

However, there is one type f>f screen stiver that needs to 
handle dniwing slightly differendy. Some .simple screen savers 
accumulate content via repeated drawing into the view. By their 
vtrry narure, they cani redniw the current state of the view 
lx?cause dicy doni keep track of whai theyVe alre;idy drawn. In 
order to accumulate content, these simple screen silvers must 
only erase the background of the view the first time they're 
a.sked to draw^ The l>asic si'reen saver example 111 lie using for 
the first part of the article falls into diis staicless category so f1l 


cover the extra bits of code youil neetl Lt> write an accumulating 
screen .Silver as we go along. 

A typical screen .saver will sulx’lass ScreenSaverView, 
override a few important methods, add a few more of its own, 
anil let the screen saver framework and engine handle the rest. 
Tlie Xcode screen saver template provide>s stub 
implementations for? key melhods but fora basic aTeen .saver 
well only need to change the -drawReci: and - 
animateOneFrame methods, override two other su[x.Tclass 
mediods, and declare a now member varrabie, 1’he rest of the 
stub code will suffice for now. 
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Figure 2, Initial screen saver project window 

First, bring up Xcode and start a new' sc reen saver project 
if you haven’t already. Youll find the template called Screen 
Saver in the Standard Apple Plug-ins list. Give ilte new project 
a creative name. IVe called my project projectName and so 
Xcode luts CTeiUed a few files for me with appropriate name.s. 
See i'igure 2 for a look at the initial project. Tlie mo.st important 
one is called projectNameVlew.m. From this point on. 111 
assume that your project is trailed projectName opcm up your 
project and follow along as we add st>me simple drawing code. 

1. Declare a new memlxT variable in the profectNameView.h file 
with this code: 

^interface projectHameViEw: ScreenSaverView 1 

// keep track of whether or not tlrowtleci : should eratje 
the background 

BOOL inDrawBackground: 

I 

2. Add a new meLlK>d to projectNameView.m called 
viewDidMoveToWindow; 

* (void)viewDidMoveToWin<iow t 

// this NSView method is called when our screen saver 
view Is added to its wltidov 

// we'll use this signal to tell drawRect: to erase the 
background 

mDrawBackgrouDd = YES: 

I 

X Replace the drawRect: methcxl in ihe pfojectNameView.m file 
with this code: 













- (voidJdrawRect^(HSlect)reel { 
if ( QLDtavBackground } t 

//draw background after vlei^ is installed In a window 
for the firet time 

riNSColor colorWitbDevicaKed: 0>0 greenr 0*0 

blue: 0,D alpha: 1,0J setj; 
[NSfle^-ierPath flllRect: [self bounds] 1 : 
mDrawBackground ” NO: 


NSRect viewBounds = [self bounds]; 
float startinaX * SSRandonaFloatBetween ( 

NSKlnXt vievBounds ), NSHaxX( viewEounds ) ); 
float startIngY " SSSandomFloatBetveen( 

NSHinYC viewBounds ). NSHaxYC viawBounds ) }; 
float width “ SSRandomFloatBetweenC 

KSWidth(vlewBounds) /20t NSWldth{viewBomid£!)/2) I 
float height = SSHandoinFloatBetweeri{ 

N5Height(vlewBounds)/2Q. NSHelght (viewBouiids) / 2] t 
NSRect reetToFili “ NSHakeRect( startingX, startingY^ 

width* height ): 

float red " SSRandoiiiFloatBetveen(0*0» 1.0): 
float green * SSRandnnPloatBetweeniO.0. 1.0); 
float blue ^ SBKandciiiiFloatBetweeri(0*0* l.D); 
float alpha ^ SSRandomFloatBetweenCO.O. 1.0): 
riMSColor COlotWithDeviceRed: red green: green 
blue: blue alpha: alpha] setj: 

[HSBes:ierPath fillRect: rectToFill]: 


4, Add d new inethtKJ \o projectNameView.m called isOpaque: 
- (BODi)IsOpaque I 

// this keeps Cocoa from unneccessarily redrawing our 
superview 

return YES: 

1 


5. Change ilic animaleOneFrame meiluxJ In project Name View, m 
to lcx)k like this: 

- (void)aniniateOneFrame I 

//request that our view be redrawn (causes Cocoa to call 
d r awRec t:3 

Iself setNeedsDisplayi YES]: 

I 


Build your .screen saver and correct any errors that Xcode 
finds. Once your project ha.s built successfiilly, ytiull finti the 
btiilf version of the screen saver in your projeefs build directory. 
L(H>k for the file named projectName.saver, 

Now that youVe built your screen saver, I neeti to take a 
moment to explain how to get the system lo recognize and display 
it. Screen savers must Ix! inslalied into one of two [ilaces on your 
system in order for the screen saver engine to load and run them. 
If you'd like to make your screen saver available to all users on 
ytnir system, use the Finder lo copy it into /Ubrary/Seteen Savers/ 
Ixii note that you1l neeti administrative privileges itir the copy 
OjDeration. If" however, you only want the screen saver to lx.' 
available to the c iirieni user, copy the plugin into -/Library/Screen 
Savers/. Once yottVe placed tlie screen saver into one of ifie two 
direaories, open System Preferenc'es and choose the Screen Saver 
tab within the Desktop and Screen Savers pane. Your new scTcen 
saver should sfiuw up in ilie list tin tlie lefl-liand side. Select it 
and click the Test button to take your plugin for a spin. 

If everything went according to plan (does it ever?), the 
screen saver engine should take cjver die display, load your 


module, and start calling -animateOneFrame fxaitxJically to 
update the sc^reen. If that's not what liappened on your 
machine, here ls a checklist of possible trouble spots. 

1. Screen saver didn't slu>w up in tlie list verify .saver extension 
and installation location, relaunch System Preferences 

2. Screen saver shows up in list bur doesn't previcw^ verify 
subview origin (if ytnfre using one) and see debugging dps 

3. ^Screen saver previews but dtxsnT test verify subview origin 
and drawing coordinates 

4. Preview draws in the wrong place verify suhview origin 

5. Screen saver craslies check console for OS and 
ScTceriSavcTEngine messages and see debugging lips 

6. Weird System Preferentx?5 pane behavior check for pos,sii>!e 
symbol name conflict with amrllicr Obfective-C bundle 

7. StTcen saver re|7eatedly draws a single random rectangle 
over a pin-striped background make .sure you spelled 
isOpaque correctly 

Did it w^ork? Great! You 11 notice that the end result isn1 
too had for a few liiies of ccxle. Tlie framew'orks do t|uite a bit 
of work for you. As a t)uick example o( the extra power 
available to your sereen saver, add the following code right 
lie fore the aiU to NSBezierPath at the end of drawReci: that fills 
the random rectangie. 

NSAffitreTransfor-tn* rotation “ 

[NSAtfineTransform ttansfonii) : 
float degrees “ SSRandomFloatBetwecn( 0.0* 360.0 ); 
IrotatioB rotateByDegree^: degrees]■ 

[rotation cotieat] : 

Build your stiver, copy it over, and try it out. Did iJie scTcen 
saver liehavior change? If not, ytni’ve [irohably forgotten to 
copy the ufxlated screen saver jilugin into the Screen Savers 
folder. Clearly, having to copy the updated build over every 
time you make a change will get (ild during development, Tlie 
simplt^si way to fix this is to add a Copy Files build phase to your 
project that copies the finished screen saver from the build 
directory' to /Library/Screen Savers/ or -/Library/Screen Savers/ 
once the butkl is com])lcte. 0|xm your projea window, select 
your screen saver in the Targets list, and select New Build Phase 
-> New Copy Files Build Phase frorn the Project incniL See Figure 
3. Once youVe added the new build [ihasc, you must set two 
additional [parameters: the source files and the destination path. 

^ ■ Headers 
^ m Bundle ftesources 
^ H Sources 
^ B Frameworks A Lib 
^ H ResourceMar^ager 
Copy Files 
^ Executables 

Figure 3. Targets list with a Copy Files Build Phase 
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If tlie Copy Files Info window isn't already open, select the 
Copy Files i’Jiiild phase and hit CMD-I lo open the Copy Files Info 
windtjw. Select Absolute Path from tlie Destination pop up menu 
and type the path to your desired installation location into the 
Path edit field, Figure 4 shows ttie Copy RIes Info window with 
the tx>rreci settings. Note: there appears to Ixr a hug (already 
filed ) in the Copy Files build phase that prevents it fwm rc-solving 
the ^ (tilde) diaracter so you c^n't jvisl t>'pe in -/Library/Screen 
Savers/ to copy your screen saver into the current user’s folder 
YouH need to type in the whole, explicit [latli ItJ the user's 
Screen Savers directory if you want to install the .screen saver for 
just the currejit user. If, on die oilier hand, you want the screen 
saver installed for all users on the niachinc, you can type 
/Library/Screen Savers/ into the Path lx>x and the Copy Files build 
phase wall work just fine. Coupled with a aistom executable in 
Xcode, you'll able to run and debug ytitir screen saver directly 
from Xcode. See the debugging section below for more 
inforniation on adding a custom executable to your project. 


nnn 


Copy Files Info 


-4 General 


Otstinatiofi: AOsolutfr Path 


FiKh: /Library/Screen Savers/ 

^ Copy only when mstallmg 

Figure 4 Copy Files Info window 

Tit set the files to lie aipied, click die disdtisun.' triangles to 
dlspby the contents of both the Products gmiip and the projectNauK^ 
target and then dmg the projcclName.savef item from the Products 
group to the Ckipy RIes build jihiise. If you do it right, you .should 
see a black liohvxjniai line wiih a cirde on the lelt end dial indicates 
where the dragged item will go when you drop it. Make sure that 
the line is jusi under the Copy Files tiuild pliasc item when you let 
go of die mouse button. See Figure S to see what 1 mean, 

" Product i 


Targets 
Y projectName 

^ ■ Bundle Resources | 

^ H Sources 
^ B Fcitmeworks & Ub 
^ B ResourceManager 
► i_ j COF ectN am e .save 

^ s/ E)teciiubJes 

Figure 5. Setting up the Copy Files Build Phase 

Another gotcha you may am into is diat die Screen Savers 
preferences pane cannot unload your old saver and load in a new 
version when you make changes while you fuive die Screen Saver 
pane open in the System Preferences applit'adon. Either quit die 


System Preferences appliaition Ixrforc making changes to your 
screen saver or, even better, add the Copy RIes build phase and 
custom executable to your XocxJe project which will allow you to 
nm your screen saver from Xcode in.steiid of the System 
Preferences application. Don't worry if you're still having trouble, 
rll cover more defiugging dps later on. In the next section, we’ll 
take a closer look at die ScreenSaverView class anti its methods. 

ScreenSaverView Class 

As I mentioned earlier, tlie ScreenSaverView class adds a 
few screen .saver specific methtxis to the NSView claims. l.et's 
take a look at iho.se new methods and see liow they work 
together to save our SKteens. Fve divided the list into two parts: 
die methixls that yoirll need to override and the methexLs that 
you'll merely need to call. 

Methods to Override 

‘ (id) nn tWlLhFrame:(NSRect)frame isPreview:(BOOL)isPrevlew 

This is ScreenSaverView's designated in ilia! i/e r. 

subclass initialisers must call this method (see itlcrcnccs for 
aiore inhirmaLiun) 

Tlie icniplate calls [super InitWIthFrameasPreview:] and sets 
the animation rale. 

*(void)d rawRect:{NSRec t)rect 

Use drawRect: to do yotir drawing. 

Call [super drawRect:] to get ScreenSaverView^s default black 
background. 

{void)animateOneFrame 

Use animateOneFrame to update any per-frame .state and 
invalidate your view. 

-(void)star LAnimation 

Tills Is your chance to set up resources and do any pre- 
pixxessing necessary for animation. 

You must at least call [super startAnimation] as shown in the 
.standard template. 

(V0id)st 0 pAnimation 

This is your chance to free up any resources all<K:ated In 
startAiiimaiion, 

You must at least call [super stop Animation] as shown in the 
standard template. 

(BOOL)hasConfigureSheet 

I'ell the engine whether or not you're providing a 
configure sheet. 

YES enables tlie Options button in the Desktop ik Screen 
Savers System Preferences pane. 

- [NSWindowDconfigureSbeet 
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Save Our Screens 
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If hasConftgureSheet ref urns YES, return tlie NS Window* for 
your sheet here 

-t- (BOOL) per f onitGammaFadcj 

Determines how the screen saver engine transitions to your 
screen saver 

* return YBS (default) for a gradual fade to black |■^efDre your 
screen saver stalls 

• return NO to have your screen saver start immediately 

Methods to Call 

• (void) setAnipfltiQnTinetnterval; 

(NSTiwo1ntorval)timeInterval 

tlmelnterval specifies the desired delay in seconds 
between frames. 

'I'he default time interval is 1/30A corresponding to 30 
frames per second. 

Zero [xills as fast as possible while a negative number turns 
animation off. 

* C BOOL)iEAnimatinB 

Check if your screen saver is currently fx^rween 
starlAnimation and stopAnimation. 

Useful for pausing calculations you don't want to fKTl'anti 
while the screen saver is idle, 

(BOODifiPreview 

Cilll this method to see if you’re Ixang asked to draw die 
small preview. 

Utility Functions in ScreenSaverVicw.h 

S KR a ndomint Be tween 

Generates a random integer in the ciexsed interval [a,b]. 

I.E. the value returned will be one of a,a+1,a+2,...,b-l,l:). 

SSRandomFloatBetveen 

Generates a random doaiing point value in the closed 
interval [a,b] 

SSRandomPointForSizeWithinRcct 

Picks a point within the rectangle, leaving gaps on the right 
and fx)ttom edges. 

SSCenteredReciInKaci 

Returns a rectangle the si/e of die first rectangle but 
centered within tlic ,sc‘cond rectangle. 

Debugging Tips 

Whether you're having trouble getting the basic scTeen 
saver up and running or youVe moved on to more advanced 


topics and are having problems, there are a numlx-r of 

debugging options and tricks available to help. 

1. One of die l)est ways to improve your ability to debug a 
screen saver is to add the Copy Files Iiuikl pliase 1 
mentioned above. Not having to copy newly built versions 
over after every cliange wall drastically speed up your 
build-run-debug cycle. With the new build automatically 
available, you can build your screen saver and then 
immediately invoke it. You’ll also want to disable the 
password protection option on your screen saver so that 
you don’t have to type in your password every time. In 
Panther, that setting has moved to the Security pane in die 
System Preferences application. 

2, Another good way to debug stTeen savers is to add a 
custom executable to your project that invokes the 
ScreenSaverEngine with the proper -debug and -module 
arguments. The -debug flag telLs the ScreenSaverEngine 
to draw your screen saver lichind all other window.s 
rather than taking over the screen. 'I'his will allow ytm to 
run or debug your screen saver frmn willun Xcode while 
still having access to your source files for debugging 
purposes. Note lhai unhandled events will still wake up 
your screen saver so you1l need to (override the mouse 
and keyboard event rnetliod,s in NSResponder.h and not 
call the implementation in the superclass. To add a 
ctrsLom executable, bring up your project window and 
select Custom Executable from the Project menu. In the 
subsequent Assistant dialog, name the custom executable 
anything you like and then set the path to 
/System/Library/Frameworks/ScreenSaver.frameworkA/ersion 
s/A/ResoufcesiScreenSaverEngme.app. Tim will add a 
new entry in the Executables group in your project. See 
Figure 6 for a look at the custom executalile Assistant. 


oo o 


Ass nun t 


Executable Name: ScreenSaverEngine 


Executable Path: /System/Ubrarv/Framtwt^rk^/ScreenSav f Choose... ^ 
Add To project, *"orojc^Name i j 




. Ptrvlam ( Finish ) 


-A 


Figure 6. The Custom Executable Assistant window 
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Select Lhai new entry and open iLs editor pane (or 
double click the entry lu open the editor in a 
separate window). Click twice on the small round 
"plus’" button directly below the Arguments section 
of the editor to add two new entries. Type in • 
debug for the first value and -module ‘"projectName" 
{note that there is no “.saver” extension needed) for 
the second. This will tell the ScreenSaverEngine to 
run your module in debug mode regardless of the 
screen saver selected in System Preferences. Figure 
7 shows the arguments in the cuslom executable 
editor. Build and tain your project. Xcode should 
bring up the Run window and Launch the 
ScreenSaverEngine application which will load and 
am your screen saver behind all of the other 
windows. 


around this problem is to override a few more event 
handlers from NSRespond©r.h. At a minimum, you 11 
need to override mouseDown:, mouseUp:, 
mouseEntered:, and mouseExited: to do noLlhng so 
that you can move the mouse into the screen saver 
window and click to restore the keyboard focus 
without waking the screen saver. Dr>n1 h^rgel to 
leave yourself some way of stopping the screen 
saver shoit of force quitting Xcode. 

Third, even with the above code in place, you 
cun run into areas where your sereen saver stale 
will get out of sync with the keyboard state. In 
particular, if you have breakpoints set on event 
handling methods like mouseDown:, keyDown:, or 
flagsChanged: you’re going to have a bit of trouble 
because the Xcode debugger will eat the 


Produas 

proJcctName.save 

Targets 

T projeerName 
Headers 

Bundle Resources 
^ Source; 

^ ly Framevvorks d Ub 
^ ^ RcsourceMaoager 
^ 3 ttop/ Flie^ 

ScreenSaverEngine 
^ £ffers and Warninp?* 


^ Executable "ScreenSaverEngine" of Project "proJectName" 


T Path to Executable 


Path /Sy s te m / U bra ry / Frame wo rk s / Scree nS aver, framework /Versions / A/ Resources /Sere enSaverEngl rve.ap p f Choose... ^ 


▼ Arguments 

I Laufich Arg u me nts 
ig -debug 

-modute ''pfoiectNarne' 


Figure 7. The Custom Executable editor 


While this setup does make debugging much 
easier, I’ve run into a few trouble spots while writing 
this article that you .should know about. 

First, as with any code, if Xcode doesn’t stop at 
your breakpoints make sure youVe i>uilding and 
debugging your screen saver using the Development 
build style. The alternative, Deployment, strips the 
delmgging symbols that the debugger needs to find iLs 
way around your code. 

Second, your screen saver will be Fighting 
Xcode for evems and ihis can cause some 
confusion. When the screen saver first starts up, it 
will have the event focus and receive keyboard 
events. However, if you click in any of Xcode's 
windows, the screen .saver will lose focus and 
keyboard events will start going to Xcode instead. 
If you were debugging a normal application, yoiiTl 
.simply click in one of its window.s to restore 
keyboard focus to the application but screen savers 
aren't normal applications, The screen saver engine 
uses mouse and keyboard events as a signal to 
disengage the screen saver so even moving the 
mouse out of the debugger window into the screen 
saver window will cause the screen saver engine to 
sliui down Lite screen saver and exit The way 


corre.sponding “up” events when you hit those 
breakpoints. If your screen saver uses tliese events 
to toggle state like 111 show later on in the event 
handling example, you will need to either toggle 
the stale variable in l!ic debugger or disable the 
breakpoint, switch the keyboard focus back over to 
the screen saver window, and give it another 
down/vjp pair st> tlial it catches the up event and 
restores the proper state. 

4. tn order to debug truly complicated event handling 
code, you may need to restart lo del>ugging live 
screen saver remotely using gdb or just logging state 
and calling sequence information to stdout using 
NSLog or print!. 

5. Cocoa has a rule that messages to nil do nothing 
and return nil. While this does help keep broken 
code limping along, it can make debugging 
particularly frusirating, especially when 
compounded by the fact that Cocoa lends itself to 
long lines of code with no intermediate variables. 
To see what 1 mean, take a look at this snippet of 
code from a section later in this article. 





























This code to load an image: 

NSBmidl&* s^verBundle = [NSBtindle bundleForClaas! 

fself claflR]]; 

NSString* imaaePath = [savei^Bundl e 
pa t h Ft) rRe source: 

imageofType: @'*JPG**] : 
WSimage" image = [ [NSlmage alloc] 

inicWithCoutentsOfFile; 

imagePath]; 


debugging in Xcode or postmortem debugging via 
NSLog and the console iog file^ add some code at 
the end of your drawRect: method to display the 
current state of your screen saven Use NSString and 
the drawing functions In NSStringDrawing.h to draw 
sUUiLs messages over llie top of your animated 
content. 


could also be written like this: 

NSimage* image = [[NSImage alloc] 
InitWithContentsOfFile: 

L[NSBundle bundleForClaes: 


class]] 


[self 


patliForRefiource i ©“test image'* 
ofType: ©"JPG"]]: 


All hough you'll often see c:ode like t he latter 
snippet, code written in this style can l>e very 
difficult to understand and debug. I'or your own 
sanity and that of anybody who has to read your 
code, please try to err on live side of tlie first 
snippet. It will make code much easier to read and 
debug, and the compiler should optimize out any 
intermediate variables so there's no penally for 
using them. 

6. Once yotiVe got your screen saver up and running 
and you're just fine-tuning your graphics algorithms, 
you can build debugging help directly into the 
screen saver. InsUNu;! of relying on .symiiohc 


Summary 

Now that weVe worked through the creation of a 
simple screen saver, taken a closer look at the 
ScreenSaverView class and its methods, and covered 
some debugging tips, this is probably a good place to 
stop and take a break. In fhe next ankle, well look 
into .some more inlcTesting topics such as adding a 
simple configuration sheet, saving and loading those 
configuration option.s using ScreenSaverDefaults, and 
bask event handling. We’ll also see how to use other 
drawing APIs within a screen saver. 


j!ill 


About The Author 

Ihvid HiB is a freelaiKe writer Bwitg in College Station, Toms. In a former Sfe, 
he worked in Apple's Developer Tedtmal Sapport groop helpiog deveb^ers 
print, draw, and write games. In Ms free time he diAMes in streen savers and 
other esoteric l^ics. 



AUTO M A T^ Y O UM M 


For more Informatioii and to order online, visit 


cocoa game 

programming 

worksho 0j 


AppleScript 

Handbook 


www.spiderworks.com 


From our brain to your brain... 

SpiderWorks eBooks 























Shine 



■ Bia 

nero 

ranCH 




Apache Bootcamp 
Cocoa® Bootcamp 
Core Bootcamp 
PHP 5 Bootcamp 
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Life with SQLm 




w 

ith Tiger, Apple has started using SQLite in many ways. 
Most notably, SQLite is the recommended store for Core 
Data applications. 



What is SQLite? 

A chit^ibase server, for example OiTule 
or Po.stgreSQU is a daemon that rcspojuls 
to requcHLs from client applications, 'fhe 
clients make requests of the server using 
Structured Query' bmguage (SQIJ via some 
client library. The server takes care of the 
security, concurrency, and distrihtiTion 
issues. 'I'he server stores tables of data tliat 
am l>e intlexed for t(uick random accuss. 


SQLite is not a database server. 


SQLite is an open-source C libniry 
written l>y Dr. Richard llipp. It creates a 
hie ihai holds tables of data tbat can Ik‘ 
indexed for quick random access. You read 
and write to this file using SQL. 'riie main 
advantage of SQLite over archiving is that 
I he data can be read and updated 
incrementally, (An archive is read in one 
big piece, and must be completely 
rewritten if the resulting object grjpli is 
edited.) Tlic perfonnance and scalability of 
SQLite is excellent - Dr. llipp's mtHher has 
every right to be very proud of him. 

You am learn all alK)ut SQLite at die 
website: 

http://www.sqltte.org/ 

Looking at SQLite files 

SQLite comes with a command-line 
t(x)l called sqliteS. The tool is installed 
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automatically with I'iger. Using sqlite3, you can interactively 
inspect and edit any StJLite file. If yt)ii are curious about how 
Cor: Data structures the file. sqliteS is a great way to exploi’e it. 
sqliteS has several non-SQL commands that start with a dot. 
.schema will show you the create .statement.s for all the tables 
and indices in the file: 

% lest.eveniMi 

eqlite> .scheim 
CttEATE TABLE ZLDCATION 

tZ^ENT INTEGER. Z_.PK INTEGER PRIMARY KEY* Z^OPT INTEGER, 
ZDETAILDESCRIPTION VARCHAR, ZNAHE VARCHAR ): 

CREATE TABLE ZPERSON 

(Z_ENT INTEGER, Z_PK INTEGER PRIMARY KEY, Z OPT INTEGER, 
KNOTES VARCHAR, ZFTRKTNAMR VARCHAR. ZUETMAME VARCHAR ): 

CmTE INBEX ZEVENT^ZOCCASION^IKDEX ON ZEVENT (ZOCOASION): 
s q 1 i t a > seku * fmm : 

5 I 1 I 1 I Bride I Laura | Sisith 
5 I Z I 1 I Groom | Craig | Adams 

Watching the SQL executed by 
Core Data 

This rip requires that you use some API that Apple has not 
yet exposed, and 1 would nor use It in a shipping application. 
It i.s, however, a great way \o unck:rsiand exataly wliat Core Data 
is doing wiifi SQLite. To log every SQL ct>mmarid sent to 
SQLite, execute the following code early in your application: 

Class p riva teCla s s i 

prlvateClass “ MSClassFromSt ring (#"NSSQLCotinect ion; 

// The compiler will give a varming here 
[prlvateClaso s&tDebugDefaulttYESj; 

Using SClLite in non-Core Data 
applications 

Tlierr are a couple of ixTtsons why you might want to write an 
ap[>lication tluit works witli SQLite files, but doesn't use Core Data: 
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1) Biickwards compatibility: Core Data Ls oaly available on Tiger 

2) Pertbrmance: While Core Dabt Ls very clever aliout which 
rows to fetch from a .sqiiie file, it fetches alJ the columns for 
tliose rows. If you know that you only need one or twtj 
columns, you may get a significant perfoniiance win from 
writing an explicit SELECT statement. 

QuickUte is an Objective-C wrapper for SQDic !>y Tito Ciiirn. 

It is an open source ffamewfjrk, and y«>u can downltxid it at: 



Website Not Found By Clients 
HTTP 404 - Website not found 


The website you are looking for can't be found 
by your clients. It may have been improperly 
marketed, had poor design, or didn't work. 
Regardless, it's not helping your business! 


Your Options: 


http://www,webbotech.com/ 


• Rent a chicken suit and stand on the 
corner handing out flyers 


One cif ihe QuickLitc example programs is 
SQLiieManagerX, a very useful Cocoa application for browsing 
and editing SQLite tiles. 



Figure 1. SQLiteManagerX browsing a SQLite file 


SQLite is not a database server 

Before we end this, let us remind you that SQLite Ls not a 
database server. If more than one user is going to l:>e accessing 
the dala, you need a database server to take care of security, 
distribution, and concurrency issues. (There are, for example, 
many stories of companies trying to use Micrexsoft Access as a 
networked datasU)re. Mtjst of die stories end with tears and a 
massive rewTite.) If your data is accessed by only one user, 
SQLite is an elegant and efficienl solution. 


'Jit I 




• Paint the company URL on your chest and 
face during a major sporting event 

• Contact SharpNET Solutions internet 
marketing and web design specialists, 
watch your traffic and rankings increase, 
get great feedback from all your 

new customers. 

HTTP 404 - Website needs SharpNET 



Not Marketing Your Site? 

If you are not marketing your 
website online, you may as well 
have a 404 error for a website. 

Web Design 
Internet Marketing 
Consulting 
Lead Generation 
Multi-Media 


1 - 877 - 583-8396 

www.sharpnetsolutions.com 
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Web Technologies 


Serving From Home 



Running A Mac Web Server With A Dynamic IPAddress 


By Danny Swarzman 


Introduction 

With Mac OS X, tlic Macintosli has iKx-omc an ideal 
platform for developing web applications. It includes an Apache 
.server All llic .services you want — FTP, PHl^, Perl, niySyi, 
'Ibmcat, etc. — are either included with OS X or are availalile 
for free. You can test the client side on the same Mactntosli that 
is running Uie -server You can edit web files with a regular text 
editor without an extra step lo transfer them to a server 

Some accounts offered by Internet service pmviders don’t 
offer ail these services. Some accounts don't include access to 
the Unix shell or don't allow you lo view system log files- useful 
when you are debugging clieiii-server cooiinunications. It 
would be helpful if you coukl use your home computer as a 
web server. 

But there is a snag. A coimnercial Internet Service provides 
a static internet Protocol address. When a user types an address 
into a browser, that address is sent to specialized servers on the 
Internet, Domain Name Servers. They lcx:ate the static IF address 
corresponding to the domain name. 

If you are connected to the Internet via a cable or IXSL 
service in your home, you don’t have a static IP address. Instead, 
you have an address that can cluinge every lime you start you 
computer. It may even change while you computer is running. 
You can't have a domain name assigned to your home server. 

'Phis article shows a way that you ran use a commercial 
Internet Service Provider account to act as your personal name 


server. ‘TTie user enters the adtiress of a wel) page on die 
amitnercial account. That page redireds the request to your 
home computer 

llie load on the commercial server is very low. Once it's set 
up, you never need to change it. You may l>e able to use a 
friend's account. Tlie only re(]uircmenl for the crimmerciai 
server is tlrat it can run scripts in perl or some similar language. 
All the changes that you make on your site after that are on the 
home Macintosh. 

'Ilie commercial seiver needs to know the Inteniet Protexjol 
address currently assigned to your home computer. A script 
running f>erk5dic2illy on home (‘ompiiter periodically sends a 
message to the commercial server to inform it of the home 
computer’s address.' 

'Hie method \r±s Us drawbacks. I'm not suggesting this as a 
replacement for a static IP address tor t'ommercial or liigh 
volume applications, fl is, however, liandy fur demonsutittons 
and iLScs that don't demand 100% reliability. 

Overview 

The basic idea is very simple. Ntiis proc:ess uses tw^o web 
servers: one on your Macintosh at home (liereafter called the 
Home Sen^'X and a commercial server (hereafter called tlie 
Redirection 'llie Home Server periodically runs the script 
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ipJo_seiver.pl. lliai script sends a request to ilie Redirection 
Server. Itie request contains the Home Server’s IP address. 'Itie 
Redirection Server res|X)ncls widi the script ipJo_file.pl wliich 
saves die Home Server’s IF address in a file. When a bniwser 
sends a request to die Redirection Server, the Redirection Server 
uses the saved IP address to redirect the client’s request tor a wdi 
paj^e Ici the Home Server (See Figure I J 

For example suppose tliiit the saved IP address is 92.2.92.2 
and the address of the Redirection Server is http://stOWlake, com/* 
t1ie user enters or dicks on a link to: 
http://stowlake.com/redirect.pl?xfile-some*html 
The script redirect.pl redireels ihe request to the die specified by 
the xfile parameier on die Home Server: 
http://92.2,92.2/some.html 


Homo Sorvflf 



Figure L Putting it all together. 


This melhcxl has several limiuitioas. First, of course, the 
Home Server ncHi'ds to l>e turned on aU the time that someone 
may want to access the pages involved. Also, tiicre can be a 
lag between the change in the IP address on the Nome Server 
and latest cycle of saving the IP address on the Redirection 
Server. When that happens, the client will fail io get llie riglu 
page. The frequency with which a dynamic IP address changes 
depends upon the t|ualiiy of the DSL connection, it can vary 
between several times per hour to several times a week. Do 
some experiments. 

Configuring the Redirection Server 

Let's gel into specific details. First, let’s see how to con%ure 
the Redireinion Server. You can use any commercL'il Internet 
server tliat suppons Perl or some other convenient language. 
Our examples are in Perl. One .script stores tlie IP address of the 
Home Server. Another rclrieves tliat address when it needs to 
redirect a request from the web client. 

Remembering the Home Server’s IP Address 

In response to a request from the Home Server, the script 
(p_to_file.pl stores the address of the sender. Listing 1 shows 
tliis script. 


Listing 1: Caching the Home 
Server’s Address 
ipjto_Jile.pl 

^!/usr/I’iin/pcrl w 

# Save IP address rcedved from Home Server to file. 

use CCI qw<:standard): 

5ipfile = ■home_server_ip'j 
print header * start^html: 

If {open IPFILE . ’">Sipf lie**) 

$Ip - $EHV|REMOTE ADORi: 
print IPFTLE $ip."\n^ 
close IPFILE: 

print '‘Wrote to file Sipfile: 

I 

else 

t 

print “Failed to open file $ipflle for writing."; 

I 

prini end_’btJil: 


Tfiis script Is a CGI script th.nt sends back a response that 
contains the U’ address that it fust .saved. 

Redirecting to the Home Server IP Address 

The redirertion script redirect.pt is .shown in Listing 2. It 
takes a single parameier, 'xfde’. That is the filcpath on the 1 tome 
Server to which the request will be redirected. 

Listing 2: Redirecting to the Home Server’s 

address 

redirect.pl 

*f!/iLsr/bin/pcii -w 

# Save IF received from Home Server 
uce CGI qw(:standard): 

* Redirect a request to the Home Server 

^Ttic file to which to Redirect is specified by parameter xfile. 

#The IP address of the Home Server b retrieved i\K file. 

- ‘honie_Eervec_ip’; 

$flleOnHoiaeEerver = paratiii*xflle’) r 

if (derinnd {$f lleDrHomeSacver)) 

[ 

Ifiopen IPFllsi:* '*<&lpfna") 
t 

chomp ($ip = <IPFILE)): 

print ^Location: http://$lp/$flleOriHoninSnrver\n\n'*; 

I 

else 

I 

print header * star t Jbtil: 

print “Failed to open file $lpfile'’: 

) 

1 

else 

I 

print hoader,ntart_html: 

print “Failed to retrieve file to access 

St‘ail=l: 

1 

print end_html: 
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Configuring the Home Server 

The script in Listing 3, ip_to_serverpl, sends a request to 
ipJoJile,pl on the Redirection Ser\'er. Tiie IT address of the 
sender is automatically sent with an HTTP reque.st. Tliea’ 
doesn’t need to lx; any special code in ipjo^setverpl for that. 

Listing 3: Sending an address to tlie 
Redirection Server 
ip_lo_sen^enpi 

^!/usr/bin/pcTi -w 

use LWPe:U serAgentE 

use HTTP::Request:iComnon qwtCET]; 

# Sent! a retjuest Lo ihe Rt-diitttion Server to save this computer's IP 

# 

# Server finds the TP in the lequest, saves it aiul returns 

* tlie IP in iLs resptmse. 

♦ This script rccoids its transactitiiis in a log file, 

# 

$kRedirectionServerAddress * 

'http; ! /tfww.siowlake♦coa/egi- bio/ip_to_filc.pi': 
open LOGFILS* "»/tap/ip_tP_server.log” 

or die “Couldn't open ip_to_server.log $r\n*; 
print LOGFILE scalar[localtime()): 
my $userAgent = new LWP;:UserAgentE 
lay ^request - GET SkRedirectionServerAddress; 
my Sresponse " SuaecAgent■>request($request); 
my $succesa - $response >ls„success(): 
my $foutid 0; 
tf[ $success ) 

[ 

my Scontent “ Sresponse’>content: 
if j $content ) 

I 

my idata " split $respqnse >catJtent: 

for{0data) 

i 

if(/Wrote to file/) 

I 

print LQGFILE “ ip was updated to: 
/{\dil,3J\.\dH3n.\dlK3l\.\dlK3l)/: 
rint LOGFTT.E $l.nn“: 
found “ 1: 

I 

1 

I 

else 

t 

print LOGFILE '^Failed to contact server: \n", 

$ response - > e r ro r_as_HTML," \n “: 

I 

print COGFILE “fulled to update ip\n“ if l$found; 


Setting It Up 

ik) we’ve got a couple tjf Perl *scripts al hand. How do we 
set this thing in moiion> 

Upload Scripts to the Redirection Server 

First, we need to upload the two Mripts ip_loJle.pl and 
redirect.pl to the redirection server. Most ISP's allow you to 
upload files using the File Transfer Protocol fF’'rP)* I typically 
use the application Fetch 4.03 to do this. You may of course 
prefer other tools. 


Depending on your ISH there may be a specific Folder 
into which you put CGI scripts. For mine, cgi-bin is its name 
and it appears when I connect to their F'TP site. Check wath 
yours. They may set up the files differenliy. Whatever folder 
you use, you need to set the file permissions Uj allow 
execution of the scripLs. Tn Fetch, use “Set Permissions.,/ in 
the Remote menu. Check tlie boxes as shown in Figure 2 For 
each of the Perl scripts. 

Permissions 


Set file/folder permissions to: 



Read 

Write 

Search/ 

Execute 

Owner: 


!? 

5! 

Croup: 


n 

51 

Everyone: 


n 

51 

Equivalent UNIX** 

command; chmod 7SS 



( Cancel ) ^'OK 


Figure 2. Setting File Permissions 

If you have access to the UNIX shell on your Rediattion 
Server, you can set permissions with Lite .shell commands: 

cbmod 755 lp_to_file.p] 
chmnd 7S5 redirect,pi 

Once the files are in j)lucc. you can test them from a web 
bnjw.ser. Enter the URl for ip_to^file. In my case, it s; 

http://www.stowlake.com/ip_to_file.pl 

A message with ihe 11^ acldres,s of your home Macintosh 
should appear in the browser window. Look for a file on your 
l.SP site called home_serverJp. It sliould Ik" in the same 
director}^ as ipJoJile.pL 

Start the Web Server on the 
Home Macintosh 

Next we need to start tlie server on the home machine. 
Open the System Preference.^ application and choose the 
Sharing panel. Check ihe box lal^eled Personal Web Sharing, as 
in Figure 3- 
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Figure 3. Starting the Web Server 

Put a Siimple web page into the directory 
/Library/WebServer/Documents on ihe bool drive, ff you file is 
called some.html, type this into a web browser’s address box: 
http://localhost/sonne.html 

If you see the page, your web server is running. 

Run a Script on the Home 
Macintosh Periodically 

The final piece of llie puzzle is to am the ipJo_server.pl a'ript 
on the Home Served. Modily tlie sample tile to user your Rediretiion 
Server by changing the value of $kRedirectionServerAddress to tlic 
address of llte directuiy on tlie Redirection Server contains die 
scripts you put drere. Put [p_to„sefver.pi in a convenient pktce on 
your Macintosh. 1 cliose /Ubrary/WebServer/CGI-Executables. 

Make die scTipt executable. Oi>en die Terminal applicatioii. 
I'he lenninal application is in die Utilities sublolder of the 
Applications folder in the main drive. Go to the directory^ tf) where 
you put ip_to_server.pl and change die pemiissions. For exain[ile: 

cd /Libirary/WfibServer/CGT-Exectitablefl 
chmod 755 ip_Lo_servet. pi 

xNow tiy ainniiig the script. Just enter- 

./ip to_Berver.pl 

You can tell if it worked with tlds command: 

cat /l:iiip/ip_to_Gerver. log 

You should see a message in die terminai window telling you 
that the li^ address was updated. 

Finally, you need to get the stripi to run periodiadly, in my 
case every 10 niinuLes. You need to use tiie command, crontab, in 


the Terminal application. There Ls a program that is always 
running, die cron daemon. It periodically scans the table created 
by the crontab command. For each entiy^ if its time has come, cron 
calls the ass(x:iated command. (You may want to review crontab 
documentaiion. Ty[)e "man crontab" into the Tenninal applicadom 
Or, you can use the application ManOpen to view man pages.) 

The first step is to create a file that speeifies when 
jp_to_server.pl is to run. Let’s call it ipJo_server.crontable. Tliis 
example says: execute the specified command at 0 minutes, 10 
minutes, after the hour. Repeat every hour of every day of 
every month, including evciy tfay of the week. The contents of 
jp_to_server.crontable is diis one line: 

0. 10.30,30,40,5f) * - * * /Library/WebServet/CGI- 
ExecuLiiblee/ip_to_fierver ,pl 

Next enter a command in the terminal window: 
gudo crontab -u username ip_to_server.crontable 

(For mcmame, substitute your login name on your Macintosh.) 
Finally to verify: 

crontab -1 

The last command displays contents of the cron table just created. 

Conclusion 

Many of us may have thought rhai signing up for Internei 
services that use a dynamic 11* address was tliereby to give up 
any hope of .serving web pages from our home computers. As 
IVe shown in this article, a dynamic iP address is really no 
harrier to doing this, Radier, we simply need to ui>Ioad a few 
simple Perl scripts to the Redirection Server and then 
tx^riodicaUy update the stored IF address by amfiing a local 
cron job. As we've seen, this is not an industrial-strengtli 
solution, lint it’s probably fine for letting your relatives view 
photos from your recent trip to Hawaii or penise your weblog. 
You need to experiment to know liow' it works for you. 
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Us er Interfa ce 
Scripting 


A s we have seen in the past, AppleScript is a great tool for 
creating some pretty amazing automated workflows. When 
iniplementing an AppleScript-based workflow, you are really 
only limited by your imagination, and by the AppleScript support 
that is available in the applications that you want to automate. 


Many scriptal)le applications offer 
enough AppleScript support for the types 
of tasks that you would want to automate 
the most. However, at times, you may find 
yourself needing to script an application 
with limited AppleScript support, and that 
one task you realiy need to aulomale just is 
not accessible through scripting. Or, worse 
yet, the application you want to auromate is 
not scriptahlc at all! 

Ilow do you handle these limitations'' 
Do you simply give up? I think not. For 
starters, you might check around to see if 
there are other scriptabie applicadoris that 
can be substituted to automate the same task. 

Another option is to consider trying to 
automate the application by writing 
AppleScript code tliat interacts directly with 
the appliotion's interface it.self. 
Fortunately, willi the release of Mac OS X 
10.3, Apple introduced a new AppleScript 
feature, user interface scripting, or UI 
Saiptinfi, whit:h can lx? used to do just that. 

What is UI Scripting? 

Ul Scripting is a feature in Mac OS X 
tliat provides a way for AppleScripts to 
interaa directly with intertace elements in 


l unning applications. For example, you might write a script tliat 
clicks a button in a window', selects a menu item in a popup 
menu, or types text into a text field of a non-scripiable applic'adoiL 

Tl ie AppleScript tenninology for VI Scripting is not built into 
AppleSciipt itself, nor is it included in a scripting addition. Itatlier, 
(Ji Saipting is part of Ajsfem EtmtU, a background application 
that provides a central location for inieracting w'ith various aspects 
of Mac OS X itself, including ainning proc'esses, or applic'ations. 

In order to view the AppleScript terminology for UI 
Scripting, open the dictionary fi>r Systmi Ei^nls l>y double 
clicking on it in the Script Editor's Ltbrar)^ palette. 



Figure L The Script Editor Library Palette and the Systein 
Events Dictionary 

If you are using a different script editor, or prefer to open 
die dictionary by seleaing File > Open Dictionary in the Script 
Editor menu bar, .Vysfem Events can be found in the System > 
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Library > CoreServices folder on your iiiacliine. In die System 
Emnts dictionary, VIScripting-rehi^tX terminology can be found 
under llie Processes Suite. We wdl exfilore die VI Scripting 
terminology found in diiji suite shortly. 

Enabling UI Scripting 

Before writing code that makes use of Ul Scripting in Mac 
OS you will first need to manually configure the machine on 
which the script will nin^ so that it can respond to Uf Scripting 
commands. To enable UL Scripting, launcii die System 
Preferences application, and click on the Uniimmi 
button. Next, enable the checkbox lalieied Enable access for 
assisthfe devices. See figure 2, 

0 0' Unlviersa] Access €_I> 

I ^ ^ 

SKowAtF OajSsIc Diiplayt Nccivaift Sharing Sofiww Llpd»e iouiid St^tupOisk 


When using the computer, I have difliculiMs with: 
f Sfekig Heartriq_ Mouse 


Turn Off Zoom 

Zoom in: 



Zoom o«t: XX- 


Zoom Options^ 

Tum loom on or off: xx:8 



Switch to White on Black 


Sfli DUpUy lo CrAyfCRle 


switch 10 white-on-htack: 


Enhinize contrasC: ^jwwhwwjij i wb»ji l ■ ^MlJJ■ilu.^iu i| . l wllll ^ll ^l ll w i .j 

hkirntal Maximum 

Reduce coin rosii WX , Increase contra si; 


^ ErubRi access for assistwe devices 
U Enable teKt-to-speech for Universal Access preferences 



Figure 2« Universal Access Preference Pane 


If the final destination for your script is another user’s 
machine, dien you should make sure ihat you provide that 
user with instructions for enabling UI Scripting on the 
machine prior to miming the script. In order to ensure that 
the user actually follows your instmetions, you may also warn 
to add some code into your script to verify tliat UL Scripting 
has been enabled, and prevent the script from proceeding if it 
has nor been enabletl. You can tell if Uf Scripiing has been 
enabled by checking the value of the Ul elements enabled 
property of die System Events application, Tliis property will 
contain a true or false value, indicating whether or nor Uf 
Scripting is enabled. 

TIic following example c(xle will check to see if Ul 
Scripting is enablecL If it is not enabled, die script will launch 


System Preferences, display the Universal Access pane, 
and notify^ the user that the Fjtahle access for assisiiw 
devices checkbox must be enabled in order to proceed. 

tell application “System Events'* to set 
IsUlScrlptliigEnablej to UI elements enabled 
if isUlScriptingKnabled = false then 
tell application "'System Preferences'* 
activate 

set current pane to pane 
“"coin. apple * preference. universelaccess” 

display dialog "Your system is not properly 
configured ld run tble script* Please select the 
\**Eriable access for assistive devices\" checkbox and 
trigger the script again to proceed," 
return 
end tell 
end if 

Add your code here* which will be triggered if UI 
Scripting is enabled 

UI Scripting Terminology 

A,s previously mentioned, die AppleScript 
teniiinolog}^ for UL Scripting is found under die Processes 
Suite in the System Events dictionary. Here, you will find 
a variety of das,ses, or olijccLs, along with a few 
commands. Let’s briefly discuss the commands first. We’ll 
see diem in action a Uttle later. 

Commands 

There are only a handful of commands that you wOl 
use for Ul Scripting, and they are click, key code, keystroke, 
perform, and select. In this article, I am going to touch on 
the click and keystroke commands, as they are what 1 have 
found to be particularly useful, and I have chosen to 
include them in die examples at die end of diis article. 

As one would expect, die click command is used to 
simukite die user clicking on an interface element. For 
example, you might use the click command lo dick a 
button on a window. 

click button I of window t 

The keystroke command is used to enter keystrokes, 
as if they were typed by a user. I’he keystroke command 
also offers the ability, through an optional parameter, to 
spedfy modifier keys dial should be invoked when die 
command is executed. For example, you may need to 
simulate the process of holding down the command key 
while typing a key. 

keystroke "P" using (conunand dowiil 

Again, these are just very brief introduedons to two 
commands that cTin be used to interact widi interfaces. 
You should spend some time exploring the other 
cx>mmands on your own, in order to become familiar w'ith 
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them. Now, let’s Luke ii look aL some oF Oie clasvses lisLcd under 
the Processes suite of die System Ewnts dictionary. 

The Process Class 

Wiicn working wilii [J7 Scripting, ilic top-level class you 
will address is the process class. A process signifies any 
process, or application, that is currently running on the machine. 
To get die names of any currently running processes, use ihe 
following syntax: 

tell application “Systetdi Events*' te return name of every 
process 

-> I “loginwindow", ''Dock”. '‘Finder", "Preview", “Script 
Editor"1 

]^r(x:esses possess a variety af properties, whieh can be 
accessed through AppleScript. One such property is tile 
frontmost property. In some cases, you may need to bring a 
prcx:ess to the front in order Lo interact with iLs interface. This 
can be done !iy setting the frontmost property of the process to 
a value of true, for example, the following code brings the 
application Preview lo the front. 

tell application “System Events" to set frontmost of process 
“Preview" to true 

Note in this example that 1 refer to the Pretftetv application 
as a process of the System Etfenis iifijilication. Be sure to 
explore the other properties of processes, as well, as they can 
provide other important information to your script. 

I have chosen to use Preview for the examples in this 
article, since Preview is not AppleScriptable, and since it is 
installed with Mac OS X, 

UI Element Classes 

A prcK’e.ss with an interface typically contains a variety of 
interface elements, such as window'.s, burtons, text fields, and 
more. These are the elements with which you will primarily 
want your script to interact. 

In die System EienLs dictionary, a UI Element is, in itself, a 
class, and po.ssesses a variety of pro[ieitie,s tximmon to most 
inteiface eleinent.s. For example, since many interface elements 
pos-sess the ability to Ix^ enabled or disabled, an enabled propert)^ 
can lx‘ found under the more* generic cla.ss of UI EiemotL 
Processes also inherit some properties from this clasps. 

'riiere are a number of different classes of interface elements 
in the Processes suite. If you have used Apple.Serijx Studio in the 
past, dien you will no doiilx Ix^ familiar with the names of at least 
a few of them, although the exact naming may be sligiidy 
diOerent from ihai of AppleScript Studio. Some of the more 
contnionly accessed classes of interface LTemenis include 
checkboxes, menus, menu items, pop up buttons, radio buttons, text 
fields, and windows. As mentioned above, since all interface 
elemenLs pt)s.scss certain characLerisLics, each class of interface 
element inherits properties from the UI Element class. 

Be sure to browse through the various classes of interface 
elemenLs listed in die Pwcesses suite. 


Referring to UI Elements 

Just like scripting any objea in a scriptable application, 
when writing code to interaa with an interkicej you must 
address the inteifaee elements within their object hierarchy. 
Dccij>hering an object’s hierarcliy within a proce.ss’ interface is 
usually no small feat. For basic interfaces, it may be as simple 
as referring to an interface element on a specific wandow. 
However, for more comi>lex interfaces, it can quickly Ixcome a 
long set of nested object references. 

Let’s take a look at an example, ’fhe following code will 
click the Drau^^r button in the tool bar of an o^xmed document 
in Preview, toggling the di^wer opened or closed. 

tell applicatlori “System Events" 
tell process "Preview" 

click button “Drawer" of tool bar 1 of window 1 
end tell 
end tell 

You can see from this example lliat in order to interact with 
the Drawer button, you must indicate specifically where die 
button is located within the interface. In this case, it is on the 
tool Irar of the front window. 

Tliere is some good news, though. Apple d^xsn’t leave 
you high and dry to figure out these object hierarchies on your 
own. ’there is a tool available to help. It is called Uf Pienient 
tmpeclor, arxl it can be downloaded from Apple's AppleScript 
web site <http://www.apple.com/applescript/uisaipting/>. 



Figure 3. UI Element Inspector 
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When hmnched, Ul JUetnetit Inspector hoars above ail 
inLerfaecs, and displays infoniiaLion ai>oLiL the interface elements 
located directly l>elow the mouse pointei: Information 
displayed includes the locatkm of the interlace element, within 
its object hierarchy^ along with values from varitms properties. 
In figure 2, UI Element Impeclor is indicating the exact location 
of the Drawer button in a Preview window - within a tool hai; 
which Is within a window cjf rhe application. As you can see, 
ilie tool bar itself does not possess a specific name, wlucti is 
wliy I referred to it as tool bar 1 in my ctKle. 

Examples 

Now, let's take a look at some examples of UI Scripting in 
action. 'Hie following example code assumes that you have a 
dtxumcni opt?ned in Preview. When this ct)de is run, ii will 
bring Preview to the front and piint the front window. 

tell applicfltiati "Systeni Events'' 
tell process "Previow" 
set frontmesst to true 

click menu iteim “FrinL-" of menu "Elle" of menu bar t 
repeat until sheet "*Frint” of window 1 exists 
end repeat 
keystroke return 
end tell 
end tell 

The hallowing example c^kIc a,ssurnes lliai you liave a 
document opened iji Preview. When this ctKle is nin, it will 
bring Ptevieu^ to the front and export the front window to the 
desktop in TIFF format 

tell application “System Events’" 
tell process “Freview" 
set frontmost to true 

keystroke using I command down* shift dovnf 
repeat until sheet I of window 1 exists 
end repeat 

tell sheet I of window 1 
keystroke "Output- 
keystroke “D"" using comiiand down 
tell pop up button 1 of group 1 
click 

tell menu 1 

click menu item “TIFF"' 
end tell 
end tell 
delay 1 

click button "Save" 
end tell 
end tell 
end tell 

Limitations 

{II Scripting is based on Mac OS X's aeeessil>ilil.y 
framework, wliicli is wliy il must lx? enabled from die Universal 
preference pane. Because it is based on the accessibility 
framework, UI Scripting can only inleracl with applications that 
have been uixiated to .support this framework. The accessiliility 
framework was first released with Mac OS X 10.2, so many 
application.^ have accessibility support builMn by now. 
However, soinv ajiidications do not, and may not a,‘,spond to UI 
Scripting tenninolog>\ 'Id atiiomate applications that do not 
siippon UI Setipting, yon may need to aim to other tools, such 
as QiiitKeys <htTp://www.quickeys.com>. 


A Third Party Assistant 

While Ul Eletneni Inspevior pmvide,H some mucli needed 
input for writing your AppleScript code, a third-party 
application take.s it a step further. 

PreFab UI Bnjwser, a commercial application available 
from PreFali Software, Inc., offers all of die functionality of 
the Ul Flemeni Inspector, and a lot more. PreFab Ul Browser 
provides robust interfaces designed for the serious scripter, 
making it easy to acce.ss information about the complete 
interface of any accessible running application. Other 
features of PreFab Ul Browser include the al)ility to trigger 
hot keys to enable and disable interface element browsing, 
auto-generation of AppleScript code to interact with interface 
elemenks, and much more. Be sure to visit the PreFab 
Software, Inc. web site <http://www.prefab.com> for more 
infonnation about this tool, or to download a demo version. 
While youTe there, be sure to check f>ut another prcxluct - 
PreFab Ul Aclions. Tliis tool will allow you to configure 
AppleScripts to trigger automatically whenever specific user 
interface actions occur in an application. For example, you 
could configure an apfilication to trigger a script whenever a 
user select.^ the Save As IVom the File menu. Tlie possibilities 
are limitless. 

In Closing 

A.s you c:an see, UI Scripting can lie (]uite a u.seful tool 
when tiying to automate an application that doesn’t provide the 
AppleScript .support that you need. So, before you decide that 
jiLSt because an applicatitm isn't scriptable, it can't be 
aulomatcd with AppleScript, lx? sure to check out its interaction 
with UI Scriptwg. 

In my experience, there is not much on the Mac that 
can’t lie automated.,, one way or another. Until next time, 
keep scripting! 

'I'ii I 
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MSXML 



Introduction 


The Data model 


Tliis is ihc first pan of u CLwt>-i>iirU article showing how Lo 
use a few of the great new pieces of Cocoa functionality 
available to developers with the release of l^iger. ‘Fhe first—the 
fot:us of this article—is NSXML, a set of Ctxx)a classes that 
iiTif>Ieinent a robust tree-based XML pander [hat provides tiie 
ability to create and edit XML from scriKch as weU as from data 
contained in files and vended through web services. 

The second new technology, which well concentrate on in 
the next installment, Ls Core Data, one of the most astoundingly 
wonderful bits of technology Apple has ever given to the Mac 
development community* 

In this month’s article, we’H build a small Cocoa applicTition 
that will retrieve hook information from Amazon’s XML-based 
web service, parse the vended data into Cocoa olejects, then let 
the user edit the data before saving it to an XML file on their 
local disk* 

Next month, well use Core Data and Ccxx)a Bindings U) 
make a version of the same application with more functionality 
ri^afs easier to maintain and suppoit, takes less time tc} build, 
and requires writing much less code* 

It’s important to noie here that you must have Tiger and the 
Tiger development tools installed, since neither NSXML nor 
Core Data are available in earlier releases* So, fire up Xtxxie 2*0, 
create a new Cocoa ApplicitLion project titled Amazon-XML and 
let's dive in. 


Our first step is to build our data mcKlel the traditional 
Cocoa way. We have to create Ccxjoa cla.sses to hold cnir data. 
Well also need to write code that will alk>w in.stances of our 
data model ofijecls to Ix^ copietl, compared, and persisted. Go 
ahead and creiite a new ol:>jecttve-C class called MTBook in your 
newly created project. Now give MTBook instance variables to 
hold our book data. 


MTBaak Instance Variable Declaration 

We’re going to store a subset of the d:it^ tliat Anuzon's web service 
pttJvides.Thc bibliogophy provides a rcfci’cnce to the Amsizon SDK wlierc 
you enn find out nioR* alwut their SDK and XML formal.The last two 
instance variables do not conic front Amazfjn. but rather :irc there to ht)ld 
addition:Ll, user provided MbrmatJon. 


©interface MTEtaok : NSObject 


NSStrlng 

NSString 

KSString 

HSCalendarDate 

NSData 

NSHutableArray 

int 

NSURL 

NSCalendarDate 

NSString 


*isbn; 

* 11 tie: 

‘publisher 

MateRsIaased: 

‘coverlmage: 

‘authors; 

salesRank; 

‘ II r 1: 

MateRead: 

‘comment; 


or course, we need to add accessor and mutator methods 
for each of these variables, as well as code to initialire the 
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object, copy it, persist it, restore it, coinpiirc it, and release its 
memoiy wlien ir*s deallocated. These aspects of huildmg a data 
model are some of the very few tedious tasks in programmmg 
Cocoa. Next [titmLli you'll see that these tedious steps are no 
longer necessary thanks to Core Data. But let's not get ahead 
of ourselves, 

Tiiese various methods are not shown in cxxle listings; they 
are standard Cocoa tasks dial have been written about 
extensively elsewhere, I used Kevin Callahan's handy 
Accessorizer program to automatically generate the accessors 
and mutators, then hand-coded the initiali/ers a,s well as the 
other methods a data object needs, such as code to copy an 
in.stance, cfimpare one instance to another, or to encode and 
dcctjdc an instance. The process of creating the MTBook class 
toc3k a considerable amount of time, even thougli it's all very 
stniightforward. If you don't feel like doing all those tedious 
tasks (and who would blame you?), feel free to copy M'FBook 
from the issue CD. 

You may be wondering why we would choose to store the 
cover image as an NS Data instead f)f an NSImage. I'he simple 
reason is that NSImage will not necessarily preserve the original 
imilge data at the same size and resolution. To avfiicl rc- 
compression and possible loss of image quality or resolution, 
we'll store tire origin a i JPEG data as retrieved. 

Architecture of NSXML 

NSXML's fimetiooality is provided by a small colleaion of 
classes, only a 
couple of which you 
will need to use. 

Most developers 
will only ever need 
to interact with 
NSXMLNode, 

NSXMLEiement. and 
NSXMLDocument, 
though some may 
use NSXMLDTD, and 
NSXMLDTDNode in 
their travels. Since 
our application is 
not concerned with creating DTDs and we are going to assume 
that Amazon's XML validates correctly, we only need to look at 
the first three: 

NSXMLDocument represents an entire X^^L dtxmment as a 
Cocoa object; 

NSXMLElement represent the various, nested nodes of an 
NSXMLDocument 

NSXMLNode represent XML “nodes". Nodes C'an he just 
alxnjt any item in an XML document (including the document 
itselD, and as a rcsuli, NSXMLNode is the parent class of both 
NSXMLDocument and NSXMLElement. Most methods you’ll 
interact with will return an NSXMLNode. 


Nodes can contain attributes and namespaces. An attribute 
Is data sLured within the node's opening XML tag using key- 
value coding and is generally used to store metadata about tlie 
node. A namespace is a special kind of attribute used to avoid 
name conflicLs among elements and attributes. Most XML you'll 
encounter probably won’t use namespaces or will use a single, 
standard namespace. As a practical matter, you can often ignore 
namexpaces when parsing XML. Amazon's XML uses a single, 
standard W3C namespace, so weVe going to ignore them from 
here on in. 

In addition to attributes and namespaces, NSXMLNodes can 
contain child ntxles. Its children can, themselves, contain child 
nodes (and so on). This nesting t)chavior gives XMl. a lot of its 
flexibility and power and is what makes a tree-l.iased parser 
sucli a gtx)d choice for many situations. 

We need to take note of two oilier boxes on this diagram 
above. One is the light green box on the far right that is titled 
(utifs). We ll talk aKnit that one shortly. The other is on the left 
side of the diagnini and is titled NSXMLParser. The downside of 
a tree-based XML parser is tliat it uses a fair chunk of memory 
and is overkill for many situations (including ours, if it were a 
real applicali<in). NSXMLParser is a .standalone class that 
implements an event-driven XML parser. It's easy to use and ha.s 
a much smaller footprini than NSXML, NSXMLParser is beyond 
the scope of lliis article, but you should know it's there and use 
it when a]>propriate. 

Handy Additions to NSXML 

Hiere is one thing dial NSXML lacks dial many other tree- 

based XML parsers 
ofltef: the abUiry to 
retrieve a child of a 
given node by its 
name. Since 

referring to children 
by name makes 
code much more 
readable, IVe 
created a category 
on NSXMLNode that 
adds this 

functionality to 
NSXMLNode objects. 

listing 1: NSXMLNodc-utils.m 
NSXMLNode utilities 

This category on NSXMLNcxle adds two bits of useM functionality to 
NSXMLNode. The first method allows retrieving a child node of a given 
name. The second converts all the children of a given node to their string 
\'aliics, allowing you to retrieve an array of a node's children with on call. 

Vou ll sec how both of these are used later in the article. 

@implamentation NSXMLNode(utile) 

- (NSXMLNode *) chlldNanied : (NSString *)na!iie 
\ 

NSEnumerator *e - [[self children] objectEniiiDetatprJ j 
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NSXMJJode *node; 

while (node = le nextObjectJ) 

if ([[node name] isEqualToString:name]) 
return node: 

rerurn nil; 

I 

- (NSArray *)childrenAEStriiigs 

I 

NSMutableArray *ret “ [[NSMntableArray arrayWithCapacity: 

[[nelf childrenl count]] retain]: 

NSEnLimerator *e = [[self childrenl objectEnumerator]; 

NSXHLMode *hode; 

while {node = [e nextObjectJ) 

[ret addObject: [node strlngVa! Liell : 

return [ret autoreleasej: 

J 

Send 


Building the Interface 

llie next step in building our upplicution is to design ilie 
interface in Interface Builder. If youVe coiiifoitable wiili the 
basics of using Interface Builder and how to link thetn to oiitlet.s 
and actions in your code* feel free to skip ahead to the next 
seciion: Coding with NSXML 

We're going to build a relatively simple interface here, just 
enough to work with, hirst, we’ll lay out our interface sf> thal it 
has fields corresponding to each instance varialjle in our dau 
mcxiel* along witli a l)utton to initiate the search, and another to 
save the revised XML to a file. Mine looks like tliis: 



Window 







ISBN: 


r . - - 


Title: 




Publisher: 


1 


Published: 12/31/2000 

xZ/ 



Airthon_ 




0 

0 



1 

■; 

Sales Rank: 


2 




Comment 


Dt Read: 12/31/2000 ^ 

Source URL 


{ Sav* ) 


Figure 2. Our Window in Interface Builder 


Next, well go in the Classes Lai), right-click NSObject and 
create a subclass of NSObject which well call 
MTXMLAppDelegate. This new class will act as both otir 
application delegate and as our main window's controller cla.ss. 
Conm)l-drjg from the File's Owner icon to the instance of 
MTXMLAppDelegate and bind it to the delegate outlet. While 
weTe here, control-drag from the Authors table to 
MTXMLAppDelegate and link to the DaiaSourcc outlet. 


Double-click on the MTXMLAppDelegate instance icon, 
whidi will open the objea inspector where you c'an add outlets 
and actions. Add actions called doSearch:, and saveToXML:. Also 
add the outlets shown in Figure 3, which correspond to each of 
the user interface elements that we’ll neetl acx:es.s to in our cxxle. 



Figure 3. Outlets 

Now control-drag from the Lookup button to the doSearch: 
outlet of MTXMLAppDelegate and repeal w ith the ISBN text fielcL 
Now control-drag from i!ie Save l>utton and bind to the 
saveToXML: outlet. If we were creating a real application where 
it was important to keep the data model synchronised with the 
interface in real-time* we would alst> have to liave an additional 
method tliat was called wlien atiy of the other field values 
ciianged. 1 mention this only becau.se real-time synchronization 
of the data model is yet another thing you get for free using Core 
Data. For t>ur littiited f)urfx>ses, we’ll simply update the model 
when tlie Save buttO[i is pressed. 

We also need to link our application delegatees outlets to 
the various fields in our window, so control-drag from the 
MTXMLAppDelegate instance icoti to each of the fiekls and hind 
to the coiresponding outlet. Once that is done, we’rc' ready to 
write some code. Go ahead and getierate the source files for 
MTXMLAppDelegate* tlien go hack to Xcode* open up 
MTXMLAppDelegate,h* and immediately following all live 
automatically generated IBOutlet variables generated* add an 
MTBook instance varial)le called l)ook, and don't foiget to 
include MTBookh. Our doSearch: method is where we’ll actually 
retrieve the XML data frtim Amazon and work witli ii. A stub 
implementation of this methcxl has been generated for us* so 
we’ll add our code there. 

Coding with. NSXML 

A.S will) most Cocoa classes, tlie NSXML classes have been 
designed to l>e easy to use and to iasiilate you from having to 
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know too much ulxiut the inner workings of the class. To 
instantiate an NSXMLDocument haseci on daia rciricved [mm a 
LIIiL, you simply alloc'iUe us nonnal and then tnitiulize the object 
using initWlthContentsOfURL:options:errar.. If you already have 
the XML in memory, you can iniiialize instead with 
in itWith Dataropti ons: e nor: i astead. 

The rcx)t ncxle is available from an NSXMLDocument by 
using the rootElement method. An array of the child nodes of any 
element can retrieved using the childran method of 
NS XML Node ^ or you can request a specific child hy name using 
the childNamed: method from our utils nuegory. To get the string 
contents of a node — the value between ilic l)egin and end 
tags—simply call die stringValue method. 

The easiest way to show how these varioiis metlxsds work 
Ls to show some Cfxle. 

Listing 2: MTXMIAppDelegate.m 
doSearch: 

This method uses NSXML to parse the results of the XML data rcirievcd fnim 
an Amazon ISBN search then stoics that data as an MTUemk object. 

' {rBActionlddSearcb: (Id)eeTideE 
\ 

// Mort" inftmnation about Amazon's XML web services is available from 

// http://tinyiirLcom/cbB9g 

// Here, wc'rc just setting up the Anuizon URL based on our assigned 
developer token 

// (assigned to tis by Ama/tm) and the ISBN rumilx:r eineted by the user 

RSString *urXBase ^ 

®“http: //ml . aijmson. com/onca/ml 3 ?t=l firdev - 
t”te&AainSearch^W?&type=heavy&f“xml’': 

MSSitln^ 'urlString " [NSStrlng stringWithFortnstlurlBase, 
AKAZON^UEV^TOKEN. 

UsbuTB" strlu^Valuel: 

NSURL "theURL ^ iNSURL URLWithStrltigiurlStrl ngl: 

// NSXML dwsn't thmw an exception on bad allocation, nor docs it 
simply return a 

// nil. NSXML acts old*sctuKil in some ways; it wants a pointer to a variable 
which it 

// will populate with an error code if there's a pnjhlcm 
NSEnror ; 

// Initialize our dtx’umeni with the XML data in our IIRI. 

HSXMLDocuiiient *xmlDoc I iNSXHLDocuoient alloc) 
InitWlthCantentsOfURL:theURL 
options mil 
error:&err]: 

// If we werc doing pmper error checking, we'd check the value of err 
here. We’ll 

// skip ii and simply check for xmlfkjc = nil later.This method wt>rks 
fine if you 

// ckrnT intend to give tile specifics of any problems eneountea^l to the 
end user 

// Get a reference to the root node 
NSXMLNode *rc>otNodo ” IxmllXoc COotElementJ ; 

// In ease of an error, Amazon includes a node called ErrorMsg, its 
presence tells us 


// that an error happened not in parsing the XML, hut rather on Amazon's 
side, so we 
// check for it 

NSXMLNode *errocRode - frootNode cbildName{Jjt'‘ErrofHsg*'b 

if troorNode — nil || errorMode I* nil) 

I 

// Well pnwide an error message in the IfRL field, blank the others, then 
ah(>rt. 

// ohjcctValuc is a method that will give you the contents tjf a node as 
an 

// NSQhjeei, which will itlways lx- a string wlien first parsed from 

XML, 

// hut which might be another ty|>e of Gocoa object such as an 
NSCalenthtrDate 

// if you cieated the NSXMl.Document prfjgrammatically as wt'H do 

later. 

// NSXMLDocument Ls smart enough to automatically eonven 
et mini only used 

// objects 1(3 the correct W3C fomiauing when outputting them to 

XML 

lurlTF setStriiigValue:lerrorNode fitringValueJJ: 

[conwnpntsTF setStringValue i 
[cuverTinage set Inage: nil 1 ^ 

[ishuTF setSlringValue:#“"h 
IpubiisherTF setStrlngValtie:^'"*]: 

[sale&RankTF setStrlngVnlueje'"']; 
ftltleTF setStringVaiun:€J"“J: 
return: 

I 

else 

1 

// If no error, the book intbrmation Ls coniained in a node called 
Details, s<J we II 

//grab it.TIiough the method aamiliy returns an NSXMLNode,we 
know that, as a 

// child of a document, we'll actually get an NSXMLBemcnt, We 
declare it as an 

// NSXMLHement to avoid casting il later 

NSXMLEleJttent 'deiall^ffode = IrootWudE 
childHaMed:@’’I>etaiis"J: 

// Release mcmor>' from any prior book, and start with a fresh object 
[book release]j 

book ^ [[HTBook alloc] inlt]; 

// Now‘ set the fields of our data model fmm singleton child nodes 
// NSStrings are easy - we just call the ,stringVaJue method on the node 

[book setlsbn: 

IfdetailsNode childNatEied:@''Aain"] sjirifigValue] ] : 

[book setTitle: 

i [d^^tsilsHode childNamed: @"FroductName '*] 
strlngValuell: 

(book selPubHshor: 

L [detailsRoda chi IdNamed :#'*Hflnu£acture c " 1 
StringValue]]; 

// Since we crated this NSXMLDocument fntm parsed XML, we'ie 
going to get 

// NSStriJigs when we call objcctValue, so dates, numbers, and others 

have 

//10 Ik manually convened from strings 

[book sEtDatekeleaeGdi [IfSCalEndarDate 

dateWithUaturalLanguagoSt ringi[fd eta11sRode 
childNained;@’'R€leasaDate") etringValue]) 1; 

// Sales rank is a scalar value 
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[book s et Sa1esRank:L LId etai1sNods 
childtJa!ned:@"SaiesRaiik"] string Value! intValuell; 

// UKL is stored as iin attribute of the Details node, not as child 
clement TJie 

// syntax for getting attributes is slightly different than for child 
elements 

[book setUrl:[NSURL URLWlthString:[[detailsNode 
att!:ibuiteFoiName :@"url"] stringVaiueJ j] i 

//Tlic XMl we retrieved doesn't have the cover image, but it docs have 
a URL 

NSm ^iflageURL = [HSUEL UELWithString; [IdstallsNode 
ehl]dNai[iGd:@'*IiiiageUrlLarge"] stringValuej J: 

[book setCovGrImage: [BiSData 
dataWithContentsOfURL; imageUkL]]: 

// Since thefe can be nioa- than one autlior of a book, Authors arc 
siorcd in a eltiid 

// list of nodes. Fortunately, we now have a handy method for reducing 
children to 

// an array of their siring values thanks to our catcgor)^ on NSXMl.Nodc 

RS}CMLI4ode *aulhorsNode ^ [detailsNode 
tbildNaiied:^" Authors"]; 

[book setAuthors:[NSMutabieArray 
arrayWithArray: [authorsNode r.hildrenAflStrlngs]]]: 

//We’U default tJic dare la.st read to today just to be user friendly 

[book setDateRead:[NSCalendarDflte date]]: 

// Okay now our data model is iXJ]iulate(l, .. but how do we make the 
interface 

// rcDcct tJicsc change!^? We call a method (next listing) that does it the 
traditional 

// Cocoa way 

[seif updatelnterface]: 

} 


//We allocated it, we’re rcsixinsiblc lor releasing it 
[xmlDoc release]; 

I 

Okay, .so doSearch: gets the ckim, pdrse.s it, unci populates 
our moclel. There's a missing link, however, which is to make 
the user interface reflect our dam mtxJcT TliaUs handled in a 
methoci cryptically called updateinterface, which simply copies 
tlie various values from oiir dam model into the corresponding 
fields of the user interhtce, another tedious hut stiTtightforward 
hit of ccxle writing. 

But wait a second. It's not as straightforw'ard as it first 
appears; there is poientially more than one author, and weVe 
chosen an NSTableView for displaying them to the tiscr. We can't 
just give an NSTableView an array to di,splay. We need a table 
data source! For t>ur simple application, well just implement the 
three required table data source methods right in 
MTXMLAppDelegatG (which we earlier specified as rhe tables' 
data source in Interface Builder, you may recall). We mention 
these tasks here, witliout showing the ctxle, to give a point of 
comparison for next month's article where well use Ct)rc Dam 


to eliminate most of these tedious, time-consuming aspects of 
building a Cocoa application. 

Once weVe taken care of updating the interfaces and 
implementing the table data source methods, we can compile 
and run our applicatitai. Type in the ISBN number from the back 
of a book youVe got laying around, click Lookup, and it should 
automatiailly populate all of the fields except for date read and 
ccanmenLs. If there's a problem with the ISBN, the error message 
will display in the lower left of the window. 



Figure 4. The Compiled Application 

Not much spit and |X)lish, but it works! One* task still 
remains, however, which is lo wiiie the code to save the data, 
with changes, to an XML file. Since we didn’t retain the original 
data we retrieved from Amazon, weT have to create XML from 
scratch. 

Listing 3: MTXMLAppDelegate.m 
saveToXML: 

This method creates a new NSXMLDocument, ix)pulates it witli 
tlie data from the user interface, then generates an XML file on 
disk from that data. 

- [IBAetionleaveToXML:(Id)sender 
f 

U Kver)' XML document needs a mot element, so we create a root 
element, then use il 
// to create our new docunieni 

NSXMIiElemerit ^root [ [MSXMLEIenieiit alloc] 

NSXMLDocuroeni: *doc IlNEXMLDocuiaent alloc] 
initWithRootEletiientrrootl; 

[root release]: 

//Well Store the soume URL where metadata .slinuld be stored: as an 
attribute rather 

// tlian as a child element 
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NSDictionary ‘attr [NSDictioimry 

dlctlonaryWitliObject: [urlTF stringValtie] 
forlCey:#"urFl: 

[root setAttributesAsDictiotiaryrattr]; 

// Now wdi store the strings 

liToot addChiid: iNSXMLElement eleuentVithNarae;#"Coiira€ivt" 
stringValue: [coraroetitsTF stringValue] ] ]; 

[rtsot addChild: (HSXMLElement elefflentWithNa]ne:#"Title" 
strlngValue:[titlcTF stringValuel3 ]i 
(root addOilld: iNSXMLElement eleinenlWitJiNaiije:»“Publisher* 
atringValue:[publisherTF striogValue]]J: 

[root flddChild: [HSXMLEleinerit elementWithNanie:@''ISBH" 
stringVaiue:[IsbnTF stringValueJ]]; 

//We couJd add the sales rank as a string, but we'll do it as a number to 
show how 

KSXMLEleineftt "rank - [NSXMLEleiaent 
elenientWithNaiBe:e’SalesRajik''1 : 

[rank aetObjectValue;[NSNumber numberWithlnt; 

[salesRankTF ItirValue] J] J 
[root addDilld: tank]: 

// f)aies tan go in either as siring or as NSDate. we'D siore iliem as 
NSDaies 


NSJCMLElement *author “ [ [NSXMLElement olloc] 
lriltyithNaiiie:#’'Nanie“l: 

[author aetStrlugValue; 

[[book autboraj objectAtIndex:ij1; 

[authors addChild:authorj : 

[author releasel; 

1 

[root addChild:authors]; 

//At this point, all oFotir data is ncjw contained in our NSXMLliocumenL 
Let's write 

// it to a file.The option NSXMLNodcPrettyPrint tells it to use tabs and 
other 

// whitespace to make the output file easier on bunun eyes. You can pass 
nil if you 

// don’t care how it looks 
HSData 'KmlData = 

[doc XMl.DataWithOptlons:MSXIllNodeFtettyPriiitl: 

// If this were a real apji, we would present a sheet and ask where to 
save. But iliis is a 

// demo, so wcYc just going to dump the file onto the desktop. 

[xmlData vritaToFile: [eWDesktop/hook.x^* 

St r i ugByExpand 1 figTl 1 d e I uPath j 3 tomi c a 11 y: YES] ; 


NSXMLEleaiaiit ‘pubiishedDate “ [NSXMLElement 
elementWithKarae i^^DatePubliahed"]: 
[pubiiahedDate sotObjectValue: 

fpublishedDateDP dateValuel1 ; 

[root addChtldjpubllshedDatel; 


// Memory cleanup 
[doc release]: 


NSXMLKlcnent -readUate » [NSXMbKlement 
e 1 (j nef11 Wi t tiNume: ® " Da t eRead " ] : 

[readDate sutObJectValue:[lasiReadDP dateValueJj; 

[root addChiid;readDateJ : 

//We'll stijre the image’s binary data. Letting the user change the image is 
// beyond the scope of this article, so we’ll just pull the image from our 
data mtKlei 

if object instead of the NSlmage’View. 

hSXMLEluiaent ‘cover “ [ [NSXMLEleroent alloc] 
initWithName:§*Covet"l: 

[cover setObJectVfllue; [book coverlmge]]: 

[root addChild:cover]: 

// Up to now, wc'vc used convenience dass methods that return an 
autoixdcascd 

// NSXMLHcment.This time wc allocated it ourselves to show how. Stna^ 
// we allocated it. wc have to release it.lTiis way is more mcmoiy' 
efficient because 

// the object is released right away witiiout going into the autorelease 
pool.'llte 

// downside is that we have to write more tines of code. 

[covur release1; 

// Finally the tiata in the author's table automatically gets updaietl in our 
data model 

// thank-s to our table data source methods, so we'll pull this array fight 
from the data 
// mtxlel as well 

NSXHLElement *authora " iNSXMLElentent 
filementWlthName:i"Authors*]: 

int i: 

for (i"0: 1 < [[book authors] count]: i++) 

1 

// Since we're in a loop of unknown si^e. we'll be kind and not use the 
// autoreleasc pool. 


Ntiw, let's compile and am again, plug in an ISBN and 
pY€ss the Save button. If all went according to plan, there will 
now be a file called book.xmJ on your deskt{>p. Open this file up 
in a text editor or XMI, editor, and you shoukl sec our edited 
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cl;ita as well-formed XML. Since we specified 
NSXMLNodePrGttyPrint, it .should iippe^ir in ti human 
readable foniiat wiili indents and line breaks, as you see 
in Figure 5 (although Fve removed the binaiy image data 
from the XML in the screenshot). 


<BcK>k 

uri=" w w .amazon .conVexec/otjidos/A SIN/I)9744 34469/ 

l?d^v-[^D34OBBJQXJFDS3%26cainp=2025%261MJc_code^xffl2'’> 
<Coinm€iit>I loved iM& book!<Coiiinieiit> 

<Tia«>Mac OS X Technology Guide to Autoniatof</Tiaf> 
<rubllshei>Spiderwofks<:/I^b lisher> 

<ISBN>0974434469</1SBN> 

<SatesRank>71639<^alcsRftak> 

<DalcPubliisfacd>2GOS-0641 T08:00:DO<TPiilePubIistaed> 
<DateRead>2005-(}6-03T20.01; I4<;UflteReail> 

- <Atithors> 

<Name>Ben Waldk:</Name> 

</Authors> 

</Book> 


Figure 5. Output XML 


Bring It On Home 


In this project, weVe used NSXML lo parse XML inUj 
Cocoa objects and to create XML from Cocoa objects. 
There's even more you can do with NSXMI.: You can 
delete nodes and edit nodes in place. You can create 
DTDs programmatically and validate existing XML 
against its D1'D to make sure it conform.s. From here, 
you should be alile to figure out any XML-related task 
you need from Api'ile’s developer documentation: 
NSXML is quite easy to use. 

But speaking of "easy to use”, you probably 
noticed that, in a few plaee.s, I menlioncd certain 
aspects of ljuilding this Cocoa application that were 
not quite as developer-friendly as one would hope. 


such as creating data model cla.s.ses and synchronizing 
the u.ser interface with Lite data model? Well, have no 
fear! Next month, weTe going to dive into an even 
more amazing new technology: Core Data. WeTe going 
to recreate this application with more funciionalily in 
less time by writing less code. 
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MAC IN THE SHELL • by Edward Marczak 


launchd: Judge, Jury, Executioner 

The Changes Apple Has Wrought 


A pple, Apple, Apple. Where to start? WeVe all now heard 
about different kinds of transitions, and launchd marks a 
huge one. For a Unix-head that was comfortable with the 
systems that launchd consumes, I had to ask: why? 


Introduction 

My wife is an artist. When we were 
just dating, 1 Ixjyghl her a set of markers 
that she had used before, and wanted for 
herself As far as she was concerned, they 
were [XTfect: tlie angles of tlie nib, the size 
of the smaller side and llie way they 
stacked up: perfect. She got about a year^ 
and-a-half out of them. Naturally, niarkenj 
Rin dry after use, and we needed to replace 
these markers. We went Ixick to the art 
sup|)ly sliop to find that the manufaaurer 
had shif)|xd new markers. Version 2-point- 
c)h, if you will. Well, my wife disliked just 
alxjui everything alxJiit the way tliese 
markers had clianged. Change for change’s 
sake. Is this the story with laimchdi' 

Investigation 

When I got my hands on Tiger during 
the Ixta pericxl, 1 wanted to test 1k>w things 
in my llicn-current environment would 
work. 1 backup iny PowerBtxjk every 
night: a perfect job for cron. After clean¬ 
installing Tiger, and moving some data 
over, 1 went to go add my nightly backup 
to cron. What's this? A little note? 


ff'l'hc periodic and atmn jobs have moved to laundid jobs 
* See /System/tibniry/LaundiDacmoiUi 

'Iliat piqued my inienttsi. I had to follow tliat trail. Of course, 
during the l)eta pericxl, you can’t just pt^t to your closest mailing- 
list asking, “what is this launchd thing?" Over in 
/Systein/Library/LaunchT>aemc>Rs, 1 found the following file iisling: 

boot psi. pHst 

cewn .apple. Kern el Event Agent. plijet 

com .apple. at tini. pliet 

con.apple.mDNSResponder.pliet 

con.apple.nlbindd.pi1st 

con.apple.periodic-dally.piIst 

con.apple.periodic-nonthly.plist 

con.apple,petiodic* weekly.plist 

com.apple.portmap-pllst 

com.apple.syslogd.plist 

com, apple, segr id agent d .pllst 

com.apple,xgrldcont rollerd.pllst 

com.vix.cron.pliet 

comsat.pllst 

eppc.pllet 

exec.pliet 

finger.pliet 

ftp.pllst 

login.piist 

nmbd.pliet 

ntaIk.pllst 

otg.isc,named.plisl 

org. pOG t fix, EnflBter . pllst 

org.xinetd.xinetd.plist 

printer,pllst 

shell,pllst 

embd.pllst 

ssh.pllst 

swat.pliat 

telnet.piist 

tftp.plisl 
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l/)()ks likt: familiar stuff, but presented in a new way. Is there a 
man page for this thing? Sure enough, there is. I’he man page 
says simply that laimchd is the ""System wide and per-iuscr 
daemon/agent manager'". A little further down, it hits me; 
^'During l>oot lannchd is invoked by tlie kernel to nm as the 
first prot'ess on the system and to furdter bootstrap the rest of 
the system." 

Kaboom 

Run as the fust process? I>on*i be silly^ tliat's iniid's job! 
Look, 111 just go find iniid in my process list and., .hmmmm. No 
initd. OK.. J ueiiilie slowly. 

First cron, and now initd. This biinehd thing is ravenous! 
What else lias it taken over? As it turns out, launeltd now takes 
the plac'e of several tried and ime systems, namely: 


init 

Startup Items 
inetd/xinetd 

watchdog (on OS X Server) 
cron 

re (almost) 


1'he rc smicture still exists, but tiiere is a note in the (very 
short) laimchd man page, that states, “At some point in the 
future, we hope to completely phase out the use of re." Six 
time-honored, tried-and-tnie sulisysiems tliai get the job done, 
and are in use on other systems. Again, it makes me ask “why?" 

Why 

Wily lake these well-known subsystems and replace tliem 
widi something unknown and untested? One thing 1 thought 1 
might find the an.swer to while at WWDC this year was the 
reason for the eliange. Turns out that there was nary a mention 
o( launeltd iti all of die sessions I attended. Hiere was so much 
other g(X)d content, that 1 didn't tlmik alxiut it all too much 
while I was there, but dien I got home and looked at all of the 
non-WWDC e-tiiail diat had acaimuiaied during my trip. 1 had 
diree requests all looking for more information relating to 
launchd (though, they just didn't know it yet), While I still don't 
have the exact aaswer to “why?", I have been using launchd and 
ids related programs tor various tasks, and it seems to work 
reasonably well. 

Apple’s OS X web page (http://www.applexom/ 
macosx/features/unix/) make.s a mention of launeltd tliusly: 

“Since Mac OS X rarely requires you to reboot, you1l liardly 
ever notice it. but Tiger takes less time to start up, ilianks to launchd, 
Launchd provides faster startup through a unified framework for 
starting, stopping and nuinaging daemons, and incorporates inetd. 


init, mach^initi System Starter and related seivices. 
Administrators have a single mechanism far audiling, 
configuring and setting resoyRX"s limils on services." 

Well, OK, that explains a little bit*..or perhaps even 
tmire than a bit. Look at whafs happening here. 
Instead of this (10.3): 

$ pB ax 

FID TT STAT TIHK COMMAMtl 

1 ?? Ss 0:00*85 /sbin/lnit 

2 27 $n 5:35.22 /sbin/i[iach_init 

Tiger gives us diis: 

PID TT STAT TIME COMMAND 

I 7? 0:04*40 /abin/tauachd 

launt:hd is now resfxjnsible for pretty much everything. 
All your bases belong to launchd! 

P to the L to the I-S-T 

Wlien you read the man page for launchd, you may 
notice under the ‘see also' section, that it mentions 
laundid.piist. If you go looking on your .system for 
launchd.plist, yoifre not going to find it. Tlieyre actually 
referring to the concept of launchd plists. 

For tlie uninitiated. *plLst" stands for “Pniperty List." 
Plists provide a standardized way for applications to store 
data, and then later retrieve this data. You can think of it 
like a l)cller Windows INI file. However, there are three 
kinds of plists: old-style ASCII, XML and litnary. The 
ASCII format has been inherited from NeXT, and still 
supfK.med for legacy reasons. The binary version wa*s 
intrcxluced widi 10.2, but has only really been pushed by 
Apple ill Tger. launchrl stores iLs plists in XML format. 
XML plists are plain-tcxi files drat can lie read by a text 
ediior. Even l>etter is to use an editor that tindersiand.s 
pitsts* Apple's GUi-based Properly List editor is one such 
editor. I also hope to have a curses based (TUI) editor 
finished by die time diis goes to print (life, however, may 
get in die way of th^il deadline)* So, for now, cO[)y 
/System/Library/Launch naemons/s.sh.plist to your 
desktop or some odier out of the way place, and open it 
with “Proj>erly List Editor" (which, under Tiger Ls in your 
Applications directory. Paniher users need to have the 
developer tool.s installed, and will find it under 
/Developcr/Applicalions/Utilities, however, if you're on 
Pandier, you don’t have launchd...hut it’s a nice exercise. 
A double-click on the plist .should launch Property list 
Editor also, if installed). Eigure 1 illustrates how the 
hicrarchal key/vakie system is displayed* 
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Figure L Property List Editor displaying sshd.plist 

Pn>pt!rly lists lire able to stoie several Coa* Fi modi Lion types 
(CFString, CFNumlKT, CFI^x)lejm, CFDate, Cl'Daia, CFArray, and 
CPT)ictjoniiry), and are realty aimed ai s£t>ring values of lO(Jkb or 
Il%s. You'll notice th*it all of the types are basically sirings and 
numlx*rs. Also, in addition to simple flat ILst of key/value pairs, 
jxirametei's in a pllst can lx* si man red hientrcliically. So, what are 
the para meters of a bunchd plLst, ^ind Ikjw do we write our own? 
Riglii this way, my friend.., 

DIY 

Tire fust thing ti> notitt? from Figure 1 is tlte ^LalK^f key. TliLs 
is a way to uniquely identify a job to launtlid. Youtl see a little later 
on wliy iaunchei need.s to do tills, 'lalx!!' am lie any value yon wish, 
however, it’s easiest Uj name it sometliing resenibiing tlie jcjb, tir 
.stick with the dtinuiin scheme Apple has atlopted (yes, ‘adopted', 
not ‘entrated'). 1he next thing to do is to specify' tlie pregnim that 
you want ter mn. Inlenestingly (or fmstnitingly), there are two ways 
to specify tills. One way, like tlie example in Figure 1, is to use tlie 
‘Program' key, and specify tlie value as the full ptah to the 
executable. Tf tlie pnignmi li^is any parametei-s, iluxse can l-je 
simified Fi tlie Pn>gramAigunieats' array key. Hie .seionti way to 
sjxx ify the program to run is to foigo the ^Pn^mnV key altogether, 
and .simply use 'PregniinAtguments’. Using tJvis ntcllKxl, the first 
value in tlie array is taken as the exeaitable, and the remaining array 
elements are the aigumeiUs. Lei's make a sample plist. First, we 
need something to mn, I low alxHit a scriiX llial sjx'ak.s the current 
time? Here' it Ls: 

^ $ mkdir bln 
$ cd bln 

-'/bin $ vl speakdate*sh 

#l/blri/basb 

say ‘date 

:wq 

(note that this is in my home directory, and Fiti running as a 


regular user, not rtx>i) 

Make sure it's executable^ 

“'/bin $ chmod 750 apeakdate..^li 

„.and test it: 

$ ./speakdate .sh 

You should htntr die current time (in 24-hour 'military' 
designation) spoken. Now wc can create our plist for launchd. 
I'm going to recommend using Apple’s PrQ|ici1y List Editor for 
the simple fact that you’ll get all of the Dl'D tag info right, and 
the editor will write pro|Xr XML without you breaking a sweat. 
We'll IcKik at it after the editor gets dirougli with it. 

Onc'c the editor t.s up, click on the 'New Roof button. Kntxk 
the disclosure triangle down on the newly CTeated rcx)t node, and 
liien c lick on die 'New Child’ button three Limes. Change the key 
names, clas.ses and values to the following values: 


Name; Lalxl 
Class: Siring 
Value: spc'akdate 

Name: OnDemand 
Class: Rcxilean 
Value: Yes 

Name: PrognimArgu ments 
Class: Amty 


Once again, highlight this array, drop the disclosure 
triangle and click on the ‘New Child' button in die tooll)ar. 
Simply chaage die value of item 0 in this array to \ye the full 
path to the script - mine’s at /Users/maroak/bin/speakdate..sh 
and ytjur'.s will vary ba.sed on your user name, 

Save this plist as '"■/Library/liiunchAgenls/speakdate.plisf. 
7he fmal plist, as seen in Property List Editor is shown in Figure 
2. (Please note that like everything else on OS X, you sliould 
follow the system hierarchy: per user files go in 
«/Lil>rary/Launch\ system-wide additions go into 
/Library/l^unch*, anti you should never touch /System/* f) 
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HOME OF THE FREE COMPUTER 
THAT’S RIGHT FREE COMPUTER! 



INFOSPEEO 768K/128K 
INFOSPEED 1.5M/128K 
INFOSPEEO 1.SIVI/384K 
INFOSPEED 7.1M/768K 
INFOSPEED 384K/384K 
INFOSPEED 768K/768K 


TeleSoho1.5M/128 $69.95 

TeleSurfer Plus 608K/128K $69.95 

Residential 768K/128K $69.95 

S0H01.5M/768K $79.95 

S0HO3.0M/384K * $79.95 

SOH03.0M/768K $79.95 

SOH06.0M/768K $139.91 

TeleSpeed 144K/144K $125.9! 

TeieSpeed192K/192K $125.91 

TeleSpeed 384K/384K $149.9! 

TeleSpeed 768K/768K $159.9! 

TeleSpeed 1.1 M/1.1M $199.9! 

TeleSpeed 1.5M/1.5M $249.9! 

Ask for business line special! 


For questions regarding sales or service, please call 
us 24 hours a day at 1-866-624-6114 







Just for completeness sake, let's see what the file realfy ItK)ks like: 

$ cat epeakdate.pllst 

<7 xml verelon="1.0" eQcoding""UTF’S’'?> 

<ID0(rrYPE piist PUBLIC "‘//Apple Computer//DTD PLIST I.O//EN'’ 
’’http: / / ww, apple. com/DTDs/PropertyList ■ K 0. dtd " > 

<plist version="1.0"> 

<dict) 

<key)Label</key) 

<string>speakdace</strlug) 

<key>OnDemajid< /key> 

<true/> 

<key)ProgramArguaentS</key> 

<array) 

<string>/Users/tnarcKak/bin/speakda ce.sh</string) 

</array) 

</dict> 

</plist> 

Again, we see that by using an editor that understands the piist 
format, a lot gets filled in for us. Of course, one could do this 
by hand, but you risk more errors that way. 

How do we control tliis launchd thing? By using a CLl 
utility named 'iaunchdcll', launchdeti can do many things, but 
for now^ let’s look at loading a piist into its environment. To 
load speakdate, issue the following command: 

launchctl load -w 

/Users/marez^/Library/LaunchAg<3iit s/epeakdat e. piist 

The ‘kxid' verb instruas launchal to tell launchd to add the piist 
to its list of jobs. Tlie *-w’ flag removes the disabled flag from 
the plisr, and updates the piist itself. We can see that it has been 
added to our per user list by using launchctl with ihe 'list’ verb: 

$ launchctl liat 
sp^akdate 

It's really l^eautiful that launchd operates on a per user basis. It 
wouldn't surprise me if we see launchd taking over user login 
items in the future. Now^ on to the magic - making it run! The 
'start' verb tells launchctl to have launchd start a job. The 
second paramelcr is the label you gave the jol> in llie plisi. It’s 
as easy as: 

$ launchctl atart apaakdate 

In a second or two, your Mac should speak the current dine 
(make sure your volume is up!), All in all, that was pretty lame, 
right? For all that work, you could manually run the script and 
have your Mac speak die time. Faithful readers of iliis column 
know that I’m all about automation, so let's get to it. First, we’il 
unload the piist: 

launchctl unload -v 

/Users/marczak/Library/LaimchAgents/speakdate.piist 

The 'unload' verb does what you expect. Like the 'load' 
verb, there's a -w’ flag. This time, it marks the piist as 
disahhdy and writes that flag into the piist. Before we run 
Property List Editor, we need a test folder for this example. 
Create AJsers/Shared/watch. Now bring up Property List 
Editor and open up our piist (use the handy Tile->Open 
Recent' menu for quick access. See? Sometimes it's the litde 
things that count!). 


'fiJt down die disclosure triangle on itoor', then click the 
'New Child’ burton. Name die key '^'atchPaihs', make it an 
array, and dien click 'New Child', Change the value for item 0 
to yUsers/Shared/watch’. Save it, load it, and invoke it: 

$ launchctl unload 

/Users /marezak/Libra ry/t^atinchAgents / speakdate. piist 
$ launchctl load w 

/Use r a/marc zak/Lib r ary/LaunchAgents/speakd a te.p11St 
S touch /Users/Sbared/vatch/templ 

Tell me you don’t think that’s pretty cool! Really, go on. Have 
ftin and do that again: 

S touch /Users/Shared/watch/temp2 

The value for "WaldiPaths" can also be lirought down to 
the file level (watching a particular file). Another way to watch 
an entire directory Ls with the use of the “QueueDirectories''. If 
differs from '‘^atchPaths" by running the program until the 
queue is cleared. 111 illustrate this with our example, once 
again. Unload speakdate, first. Load up the [ilist into Property 
Editor. Change the “WatchPaths” key name to 
“QueueDirectories’'. Save, quit and load it with launchctl. 
You’ll notice tha[...uh...hello? You can stop now. Really. 
Plca.se, stop telling me the time. I'm Ix^gging you! The quick 
and easy way to keep the script loadetl, but make it idle is to 
dettr the queue directory: 

$ rm /Users/Shared/watch/* 

Ahhhh, peace and quiet. "QueueDjrectorie.s" i.s a great way to 
have a .sc:ript process items that come into a directory and need 
to lx dealt with. Of course, youll need to move or remove 
them once you've processed them. 

Just like cron! Kinda... 

As mentioned, in Tiger, launchd has taken the plac'e of 
cnin...mostly, cron does still exist and will run jt)l)s that you put 
in the various enmtab files (thankfully - see “Utopia, it's not”, 
below). If you want to do ii the launchd way, there are two 
sepaniie keys that will help. "Start!nterval" takes a numeric value 
(“n”), in seconds, and cause.s the job to fire every n seconds. This 
one’s simple. So .simple, that 1 even want to introduce an 
additional key: “RunAtLoad”. "RunALkyad” takes a lioolean that 
determine.^ if the prognim inns once when loaded, or not. Just 
so this dexs what you expect, well u.se it in our example. Do die 
launchctl unload' and edit dance once again. Delete the 
"QueueDireaories" node. Add a new Boolean key oiled 
“RunAtLoad" and make sure its value is ‘yes’. Add another key, 
this time numeric, called “Suirtlniervar. Make the value 10. Save 
it, and go load it. You should immediately ht^ir the time spoken, 
and then every ten seconds after. Startliiterval: says wliat it does, 
does what it says. IJnkxid it when you’ve heard enougli. 

According to the man page, the “StartCalendarlntervar 
key is supposed to cause “the job to tx started every calendar 
interval as specified. Missing arguments are considered to be 
wildcard. The semantics are much like crontab". Well, it's 
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.supposed u> - please see “Utopia, it's not,” below. Let's nm 
our example again. Edit the plist once again. 

Delete the ‘'iitartlntervai'' key, and create a new one named 
“Sta^tCalendar^me^val^ Make iLs class a diaionary, and tlien 
add two children. Each child should be a number. Name the 
first child key 'Hour' and the second 'Minute’, 'Hour' is Lite liour 
number, from 0 to 25, and minute is tiic minute, from 0 though 
39, Just so you can hear this job run, choose soniething in alx>ut 
5 mitiiites from the current time, 1 want my list to nm al 8^30pm, 
as you can see in figure 3, 



Figure 3. Our sample plist now using 
<StartCalendarlnteival> 

Save the new version, and then use launchctl to load it up. 
When the clock strikes tlie appropriate hour and minute, the 
script will run and you1I hear the time spoken. A.ny values that 
are left out, are considered cron-like wildc'ards, tn our case, this 
script Is intended to run at 8:30pm every day, of every month. 

Didn’t you mention xinetd? 

Yes, launciid also takes over for xinetd, and there's a 
whole host of ways that it stays compatible. Tlic interesting 
thing is the way launt:hd liandles lIils. In Apple's quest to 
spc'ed up lK>t)t times, launchd basically fakes the fan that 
there’s a bunch of programs to start, and it dt^esn't really start 
any of the ones that would traditionally l)c started. It does read 
the plisLs and figure out which fX)rts to reserve and listen to. 

Since you’ve probably had enough editing of plists for now, 
let’s look at two services that Apple had been running lltrougli 
xinetd, and how they made the transition to launchd. The first 
of tliose iKring sshd (which, on other platforms I’ve dealt with, 
usually Rins standalone), and the second, ftpd. 

We saw the pli.si for sshd back in figure 1, and there’s a lot 
going on in there! Try ioobiiig at die file itself: 

<?iml vers loti"" LQ“ eticodltig-"HTF-8"?> 

<!D0CrrYPE plist PUBLIC -//Apple Computer//DTD PLIST 1.0//EN- 
“http ://www. apple. cofli/DTDs/PropertyLlst-KO.dtd") 

<plist ver6lon“"l.O”) 

<dlct> 


<key>Labe1</key> 

< St ring>com.o pens s h.sshdC/s t ring> 

<key>PrograB!</key> 

< s tr ing > 7ufi r /1 ifae xec / s shd - key ge n - vr appe r < / s t riiig> 

< key> P rogr atcAr gume n t s < / key > 

<array) 

<etring)/usr/sbin/6shd</string) 
<string>‘i</string> 

</art3y) 

<key>SeBsiDnCreate(/key) 

<tnje/> 

<key>Soc:kets</key) 

<dict> 

<kfiy>Li3teiiers</key) 

<dict> 

<key>BonJour</key> 

<array) 

<string>ssh</string> 

<3tring)sftp-ssh</Btring> 

(/array) 

(key)SockServlc cNarae(/key) 
<etring)Esh</string) 

(/diet) 

(/diet) 

(key) S ta rvd a rd E r ror Path< /key) 

(string)/dev/null(/string) 

(key)inetdCtnnpatibiH ty(/key) 

(diet) 

(key)Wait</k€y> 

(false/) 

(/diet) 

(/diet) 

(/plist) 

YouVe already seen 'Label', 'Program' and 
'ProgramArguments’. Here's the goodies; “SessLonCreate”, 
“.ScH-kets” and “inetdCompatibility”, 

“inetdCompatibiliry” is really the !hru,st of this whole 
thing, so ril start there. This lelLs launchd tJiat this program 
thinks that it's Ixung run though inecd/xinetd. 'llie 'waif 
subkey is the analog of xinet's wait panimeter. Basically, we 
need to know if this program is single or multiHhreaded. If if s 
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single-threaded, you want to set 'Wail' to true. This way, 
launchd runs the program, and then stops answering for it. If 
set to false', launchd will coniinuc to accept connections for 
the program, and spawn new copies as needed* Stjmew'hal 
undocumented is the fuel that a separate program, 
‘launchproxy’, handles programs that need ineld compatibility* 
"launchproxy' has a short little man page, but isn't merilioned 
in launchd's other man pages* 

“SessionCreate" is also m()stly undocumented. 
Undoc'iiniented as far as the man page, Apple Developer cIck's 
and that iiltle thing called Google, Of course, there's always tlie 
source. Defining this key reaches into Applets security 
framework and creates a security session for tlie launcfied 
progniin. Now, this only works if “inetdCompatibility" is not 
configured to wait. 

“Sockets” b an optional key that tells launchd to use on 
demand sockets to trigger the iob. Tlie job can chcck-in and get 
a copy of the file descriptors in use. ‘lliere are several suivkeys 
that go along with ^S^x:keLs”, such as: 


LLsteners/SockScrviceName - Important one: determines the 
*serviee tlut the program 'bind's or 'connect’s to, based on 
/etc/services. (Tltis can gel a little fnisiraling* For example, if 
you want to run ssh on an alternate ixirt, you need to add it in 
/eic/services, and then tell the plist that the “SockServiceName" 
should bind to llial allemale name. GcK)fy). 
iJsteners/BonJour - This is an incredibly ea*sy way to register 
the service with the mDNSKesponder. Brilliant. 


yuick example: on a server, look at the proc’e.s.H list liefore 
anyone tries to access it over ssh: 

^ ps ax I grep ssh 

15922 pi 0:00,01 grep ssh 

N(r permanent s*shd is running. Once someone gets in via 
ssh: 

ps ax I grep [slsh 

15939 ?? S 0:00.11 /usr/sbin/sshd -i 

launc'lul is doing its job* As promised, herc’s ftp's 
launchd.pllst: 

J/ cat /Syntem/Llbrary/LaunchDaemons/ftp.plist 
<1 xia3 1a 100^=" 1.0 ” sneoding"UTF- 8"'? > 

<!D0CTO'E plist PUBLIC “'//Apple Computer//DTD PLIST 1*0//EH" 
“bttp://www.appie.coni/DTDE/PropettyList-I*0.dtd"> 

<plist version*" 1.0'‘> 

<dlct> 

<Key>Difiab1e£K/key> 

<t.rue/> 

<key>T.,sbeK/key> 

<St on* apple. tpdC/ string> 

< key >P ro gram</key > 

<stri nB>7uEr/iibexec/xf tpd</,<!tr i ng> 

< key) P rogramArgumeuts < / key) 

<array> 

<Btring>xftpd</strlng> 

(string) a</string> 

(/array) 

<key>Sockets</key> 

(diet) 

<ke y)LiEteners(/key) 

<dlct> 


(key > SockPa s s1ve</key > 

(true/) 

< key)SockSe rvic eName</ke y) 
<string)ftp(/Erring> 

(key>SockType</key> 

<string>SOCIt STREAMC/string) 

(/diet) 

</dict> 

(key)inetdCoinpatlbi 1 Ity (/key) 

(diet) 

<key>Wait</key> 

(false/) 

(/diet) 

(/diet) 

(/plist) 

The key differences from sshd's plist are the keys 
"SockPas,sive” and ^Socklype": 

SockPassive- Is this a li.sien' socket, t)r connect? Default/true 
is 'lislen'. 

.S4>ckType - what kind of socket to create (stream - the default, 
dgrani and set [packet)* 

Again, these are part of the “StKkeLs" key. 

Avertissement! 

lliere are certain ways that launchd expects a daemon to 
liehave. Sf)edfiatlly (and this is right from the man page): 

A daemon or agent launched by launchd MUST NOT do 
the following in the prc>c:ess directly launched by launchd: 

- fDrk(2) and have tlie [larent prexess exil(3) or 

_exil(2)* 

- Call daemon!3) 

A daemon or agent launched by launchd SHOULD NOT 
do the following a*s a part of their startup inifializ;ition: 

- Setup the user ID or group ID, 

- Setup the working directory. 

* chn>ot(2) 

- setsid(2) 

' Close “stray” file descriptors, 

- Change ,sldio(3) to Alev/null, 

- Setup resource limits witii setrusage(2)* 

- Setup priority with setpriority(2). 

- Ignore the SIGTKKM signal, 

A ckiemon or agent launched by launchd SHOULD: 

- Uiunch on demand given criteria specified in 
the XML property 

list. More inforimtion can lie found in Iaunch(3). 
- Catch die *S1GTERM signal. 

Tliose are some pretty important guidelines* Mind them as 
you're writing your .scripts! 
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Utopia, it’s not 

While luunchd has a lot of great features^ it ain still Ik' a 
little rough arountl the etlges, soniewliai typical of a Wotoh 
release. In partkailar: 

Sometimes, nrthing happens. I’ve had problems witli 
laimehd that, afier ItKiding a plist, 1 can't get the job to start. 
However, after a relxx>t, the same plist runs just fine. Can't 
explain that one just yet. 

Sometimt!S, soiueihing hapfK^ns, just not what I exj>ect. Again, 
a nclKx)t .seems to lix it. Case in pt^int: wlxle testing the plist for 
tliis aitide, I wrote the sample and loacieti it. 1 coukl siait it jiust 
hne. llui a.sking for a list gave rne: 

coni.apple.launchd.fii'stbom: execveC): No such file or directory 

...and ilien laundictl needed to Ix" kilted to get my prompt IxK'k. 
Mera relxx)l, the same, untouched plist loaded and listed just fine:. 

It's the intencied replac^ement for m>n, however, tliere are 
two probierus; 

U doesn’t fully encompass everything cron can do. Such as 
run a command in a limited scope, such as every 3 hours, 
Moneby thotigh Frkby, tmly ixiween 8am and 8pm H-ZO/3 

• ^ 1-5 root /t)atli/to/program", for example.) 

<Sta ttCa lend a rl nterva I > df xsn i work! We 11, it d{ le.s... t >nce, 
After which, it never tires again. Not fixed in 10.4.1. (hopefully, 
10.4.2 nails tills issue downX 

No graceful way to unload a cbemon. Now, some hard¬ 
core Unix folks will yell at me alxxil Lhis one. That’s just how 
some nnicies work. OS X has SystemStaner to deal with this, 
and it’s still in place. 1 imagine that launchd will someday 
overtake this system as well. Howevc^r, if you have services tlial 
need to lx‘ staned i>r slopped a very specific way, you may find 
iltai writing a Startupltem is, for now, the w^ay to go. 

'llie workarounds for now seem to lx; tlie u.se of the 'old' 
systems: c rt>n and .SysiemStancr. If you need some very' specific 
way to shut down a process (fmserver users, fm looking in your 
direction), make it a Startupltem. 1 have OpenBa.se running on 
some 7'iger systems this way. Wijrks just fme. 

As for SlartCalendarlnlerval, welh just use cron. You can 
simply copy over any crontab entrie.s you had been using on 
Panther, or create new entries, and put them in the appropriate 
place. Apple was kind enough to make sure that launchd calls 
cron to nm any jobs tliat it should. Of course, ycni can use 
launchd to unload and redoad cron: 

if launchctl unload 

/ Systein/Library/LaunchDaemons /com. vix, exon, pi is t 

# Igiincbctl load 

/ S y s tea /!, Lb ra r y / LaunchDaeiBon s / com. vix. c ron .plist 

cron also remains the more Oe.xible of the two in terms of 
.sclieduling tlexibility. Tliat's life on the edge, I suppose. 

What about watchdog? 

Yes, I did mention that laimchtl replaces watchdog. Thi.s 
lakes place thanks to the ‘'On Demand” key. When tjiis Btxilean 
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Mrww. fDMrcosfcflcill n0. com 






key is set to 'false', launchd watches die prtx:ess and restarts it 
if necessary. Try this plist: 

version""! .0" encoding^-UTF'S"?) 

CIDOCTYPE plist PIJBLIC "-//Apple Computer//DTD FUST K0//EK" 
“http; / /vww. apple, coia/DTDfl /PrapertyLlst - K 0. dtd" > 

<pliat version^"1.0"> 

<dict> 

<key>LabeK/key> 

< si r 1 n g> 1 GalFore ve r < / St r ljig> 

< key >0nD emand </key> 

<false/> 

<key> P ro gramAr gument s </key> 

<array> 


< 2 tring>/AnplioatIons/ICal* a pp/Contents/MscOS/iCal</string) 
</array> 

</dlct> 

</pllst> 


Ixiad it into laimchcl: 

$ launchctl load 

/Osers/nmrcztk/Llbtary / LaimchAgefits/leal forever .plist 


There's iCal! Now, try to quit it. Back it comes!.*,and again icll 
it to quit>..dicre il is again! Unload the job to rid yourself of iCal 
for a bit: 

S launohctl unload 

/Uaers/marc3Eak/Library/LaunchAgents/lealfotever.plist 

If you really were tjuitting it quickly, and you still had your 
terminal vi.sihle, youll notice a series tjf messages: 

launchd 11447] : iCslForever: e5?ited: Terminated 

launchd[1447] : ICalForevor: reapawuing too qulcklyt throttling 

launchd11447]: iCalFotever: 9 more failures without living at 

leaut 60 seconds will cause job removal 

launchd 11447]; iCalForever: will restart in 10 seconds 


Tills is really nice protection against some job going lioiikers 
and taking down your system. 


Conclusion 

So, is launchd really like my wife's situation with her 
ilktslralion marker;? Is it re^dly just change for changers sake? In 
this case, tlic answer is no. Just as the Unix world went through 


the transition from stand-alone daemons to inetd, and ultimately 
xinetd, we're ready for launchd, 'llie real question is if launchd 
Is ready U^r us. Fonunately, cron and xinetd are still in place and 
are called by launchd. cron continues to do the right (and more 
flexible) thing, so use it if you need to. Launchd is extremely 
vemitjn one-dcjl-oh, IxH I expect that it will come up to speed 
very quickly. All in all. launchd has the right motivation: a 
unified way of launching and managing daemons, no matter 
which stage of system operation theyVe run at. 

I diink tliat most people’s gripe with humchd is simply the 
scarcity of documentation. The Tiger server docs briefly 
mention launchd, and even in those cases refer you to the man 
page. Actually, that’.s something that even J Iiaven't done yet! If 
you do want to dig into launchd, you sliould read the man 
pages. While you will .still be left with some questions, il does 
get you going. 

The “Utopia it's not" section alx>ve lists a few workarounds 
to launchd's bugs. Even in the source code, ilicre's a TODO list. 
One of the items on the list? “cron”. Another? 
“Documentation". Indeed. 

I was just atout to fuackage tilts month's column up, and get 
it in for print when I was made aware of a [ilist edliot specijtcally 
for launchd items. 1 haven't used it, so I can't vouch for it, but it 
looks nice. It's called (amazingly), “Inimehd Fditor”, and can be 
found at <htip;//wwwxodeixxniy.net/f)roducts/launclideditor>. 
Wonh a mention. 

Dig in and experimeni with launchd - it’s proi^ably the l^est 
way to learn its many ins and (Hits, ril certainly be following 
the development of laimclid pretty closely, and will \yc updating 
you as I know more. 

\\\\ 
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